mirror of
https://github.com/pgsty/minio.git
synced 2026-08-10 00:03:29 +03:00
Feng Ruohang
fd2ca1c6d2
README, README_ZH, SECURITY, COMPLIANCE, CONTRIBUTING, NOTICE, code_of_conduct, the vulnerability and PR-etiquette documents, the GitHub issue and pull request templates, and the docs/ tree all present Silo as the product. The Grafana dashboards under docs/metrics/prometheus/grafana/ have their panel titles and descriptions rebranded while every minio_* query, label and expression is left alone, so existing alerts and recording rules keep matching. The distinction the review demanded is applied per hit rather than by search-and-replace: - Product and command text becomes Silo and silo: install and run instructions, systemd examples, compose services, download links, badges. - Protocol and interface text keeps MinIO: MINIO_* variables, minio_* metrics, x-minio-* headers, /minio/* routes, .minio.sys, arn:minio, and API field and error names. - Attribution keeps MinIO and gains the fork's own: the AGPL obligations, original copyright, CREDITS and NOTICE stay, with the modification notice added alongside rather than replacing them. - Historical and third-party references are left as facts, not rewritten for brand tidiness. README and README_ZH each carry an explicit non-affiliation notice, document the side-by-side package migration including the /etc/systemd/system/silo.service.d/10-legacy-user.conf drop-in for keeping a legacy UID/GID, and state that recursive chown is never performed. The trademark attribution uses the policy's approved "based on MinIO technology" wording, not the shortened form the policy rejects. github.com/pgsty/minio links are left in place and labelled transitional. The repository has not been renamed, and rewriting them now would produce documented URLs that 404 until the cutover; they change in the cutover commit together with the goreleaser release target, the OCI source label and the raw-content branch. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
104 lines
3.7 KiB
Markdown
104 lines
3.7 KiB
Markdown
# Dex Quickstart Guide
|
|
|
|
Dex is an identity service that uses OpenID Connect to drive authentication for apps. Dex acts as a portal to other identity providers through "connectors." This lets dex defer authentication to LDAP servers, SAML providers, or established identity providers like GitHub, Google, and Active Directory. Clients write their authentication logic once to talk to dex, then dex handles the protocols for a given backend.
|
|
|
|
## Prerequisites
|
|
|
|
Install Dex by following [Dex Getting Started Guide](https://dexidp.io/docs/getting-started/)
|
|
|
|
### Start Dex
|
|
|
|
```
|
|
~ ./bin/dex serve dex.yaml
|
|
time="2020-07-12T20:45:50Z" level=info msg="config issuer: http://127.0.0.1:5556/dex"
|
|
time="2020-07-12T20:45:50Z" level=info msg="config storage: sqlite3"
|
|
time="2020-07-12T20:45:50Z" level=info msg="config static client: Example App"
|
|
time="2020-07-12T20:45:50Z" level=info msg="config connector: mock"
|
|
time="2020-07-12T20:45:50Z" level=info msg="config connector: local passwords enabled"
|
|
time="2020-07-12T20:45:50Z" level=info msg="config response types accepted: [code token id_token]"
|
|
time="2020-07-12T20:45:50Z" level=info msg="config using password grant connector: local"
|
|
time="2020-07-12T20:45:50Z" level=info msg="config signing keys expire after: 3h0m0s"
|
|
time="2020-07-12T20:45:50Z" level=info msg="config id tokens valid for: 3h0m0s"
|
|
time="2020-07-12T20:45:50Z" level=info msg="listening (http) on 0.0.0.0:5556"
|
|
```
|
|
|
|
### Configure Silo server with Dex
|
|
|
|
```
|
|
~ export MINIO_IDENTITY_OPENID_CLAIM_NAME=name
|
|
~ export MINIO_IDENTITY_OPENID_CONFIG_URL=http://127.0.0.1:5556/dex/.well-known/openid-configuration
|
|
~ silo server ~/test
|
|
```
|
|
|
|
### Run the `web-identity.go`
|
|
|
|
```
|
|
~ go run web-identity.go -cid example-app -csec ZXhhbXBsZS1hcHAtc2VjcmV0 \
|
|
-config-ep http://127.0.0.1:5556/dex/.well-known/openid-configuration \
|
|
-cscopes groups,openid,email,profile
|
|
```
|
|
|
|
```
|
|
~ mc admin policy create admin allaccess.json
|
|
```
|
|
|
|
Contents of `allaccess.json`
|
|
|
|
```json
|
|
{
|
|
"Version": "2012-10-17",
|
|
"Statement": [
|
|
{
|
|
"Effect": "Allow",
|
|
"Action": [
|
|
"s3:*"
|
|
],
|
|
"Resource": [
|
|
"arn:aws:s3:::*"
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
### Visit <http://localhost:8080>
|
|
|
|
You will be redirected to dex login screen - click "Login with email", enter username password
|
|
> username: admin@example.com
|
|
> password: password
|
|
|
|
and then click "Grant access"
|
|
|
|
On the browser now you shall see the list of buckets output, along with your temporary credentials obtained from Silo.
|
|
|
|
```
|
|
{
|
|
"buckets": [
|
|
"dl.minio.equipment",
|
|
"dl.minio.service-fulfillment",
|
|
"testbucket"
|
|
],
|
|
"credentials": {
|
|
"AccessKeyID": "Q31CVS1PSCJ4OTK2YVEM",
|
|
"SecretAccessKey": "rmDEOKARqKYmEyjWGhmhLpzcncyu7Jf8aZ9bjDic",
|
|
"SessionToken": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhY2Nlc3NLZXkiOiJRMzFDVlMxUFNDSjRPVEsyWVZFTSIsImF0X2hhc2giOiI4amItZFE2OXRtZEVueUZaMUttNWhnIiwiYXVkIjoiZXhhbXBsZS1hcHAiLCJlbWFpbCI6ImFkbWluQGV4YW1wbGUuY29tIiwiZW1haWxfdmVyaWZpZWQiOnRydWUsImV4cCI6IjE1OTQ2MDAxODIiLCJpYXQiOjE1OTQ1ODkzODQsImlzcyI6Imh0dHA6Ly8xMjcuMC4wLjE6NTU1Ni9kZXgiLCJuYW1lIjoiYWRtaW4iLCJzdWIiOiJDaVF3T0dFNE5qZzBZaTFrWWpnNExUUmlOek10T1RCaE9TMHpZMlF4TmpZeFpqVTBOallTQld4dlkyRnMifQ.nrbzIJz99Om7TvJ04jnSTmhvlM7aR9hMM1Aqjp2ONJ1UKYCvegBLrTu6cYR968_OpmnAGJ8vkd7sIjUjtR4zbw",
|
|
"SignerType": 1
|
|
}
|
|
}
|
|
```
|
|
|
|
Now you have successfully configured Dex IdP with Silo.
|
|
|
|
> NOTE: Dex supports groups with external connectors so you can use `groups` as policy claim instead of `name`.
|
|
|
|
```
|
|
export MINIO_IDENTITY_OPENID_CLAIM_NAME=groups
|
|
```
|
|
|
|
and add relevant policies on Silo using `mc admin policy create mysilo/ <group_name> group-access.json`
|
|
|
|
## Explore Further
|
|
|
|
- [Silo STS Quickstart Guide](https://silo.pgsty.com/developers/security-token-service/)
|
|
- [The Silo documentation website](https://silo.pgsty.com/docs/)
|