Pub vanuit CI
Uw CI leest en publiceert uw privépackages zonder opgeslagen secret. Elke job bewijst welke repository hij is met het eigen identiteitstoken van de CI-provider en krijgt een Pub-token dat 15 minuten geldig is.
Zo werkt het
- Koppel de repository. Open in de Control Room Organization en zoek CI access. Met Bind a repository legt u vast welke repository’s CI-runs namens uw organisatie handelen, eventueel alleen vanuit één workflow, environment of branch. Een eigenaar of beheerder koppelt.
- Geef het packages. Elke koppeling is een CI-lid van uw organisatie. Met de knop Packages geeft u het packages om te lezen, of om te lezen en te publiceren, precies zoals voor een teamgenoot. Zonder toegang leest het de globale packages en de engine van uw organisatie, als die er een heeft, en publiceert het niets. Wie de koppeling verwijdert, verwijdert het lid en alles wat het had gekregen.
- Wissel in de job. De job vraagt zijn identiteitstoken aan voor de audience
https://dartastic.ioen stuurt het naar de uitwisseling met de id van uw organisatie, die op hetzelfde scherm “Organization” staat. - Gebruik het Pub-token.
dart pub token addgeeft het door aandart pub getendart pub publish(flutter pubwerkt op dezelfde manier).
Uw CI-provider
| Provider | Voordat u koppelt |
|---|---|
| GitHub Actions | GitHub.com wordt al vertrouwd. Voor GitHub Enterprise Server voegt een eigenaar de issuer ervan, https://<your host>/_services/token, toe als eigen issuer van deze organisatie. |
| GitLab CI/CD | GitLab.com wordt al vertrouwd. Voor een zelfbeheerde GitLab voegt een eigenaar het adres ervan, https://<your host>, toe als eigen issuer van deze organisatie. |
| Bitbucket Pipelines | Elke Bitbucket-workspace heeft een eigen issuer, dus een eigenaar voegt die eerst toe: kies in “CI access”, onder “This organization's own CI issuers”, Bitbucket Pipelines en vul de URL-naam van de workspace in. |
| CircleCI | Elke CircleCI-organisatie heeft een eigen issuer, dus een eigenaar voegt die eerst toe: kies in “CI access”, onder “This organization's own CI issuers”, CircleCI en vul het organisatie-id in. |
De uitwisseling
De job stuurt zijn identiteitstoken als bearer-token en de id van uw organisatie als body:
shell
curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
-H "Authorization: Bearer $CI_TOKEN" -H "Content-Type: application/json" \
-d '{"orgId":"<your organization id>"}'Het antwoord bevat het Pub-token en wat het mag doen:
json
{
"token": "dtc_…", // the Pub token, valid for 15 minutes
"keyId": "…",
"organizationId": "<your organization id>",
"packages": ["my_package"], // what it may publish ([] when it only reads)
"packageAccess": { … }, // what it may read
"expiresAt": 1767225600 // seconds since 1970
}- Elk identiteitstoken wordt één keer uitgewisseld. Wissel één keer per job, aan het begin, en bewaar het Pub-token voor de latere stappen van de job.
- Het Pub-token leest de globale packages, de engine van uw organisatie als die er een heeft, en elk package waartoe het CI-lid toegang heeft, en publiceert de packages waarvoor publiceren is toegestaan. Meer kan het niet.
- Elke uitwisseling staat in de “Audit Log” van uw organisatie, met de repository, de run en de commit.
Als de uitwisseling weigert
Een weigering noemt eerst de reden, zodat de log van de job die letterlijk toont:
json
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Reden | Wat te doen |
|---|---|
CI EXCHANGE ORG MISSING | Het verzoek noemde geen organisatie. Stuur {"orgId": "<your organization id>"} als body. |
CI OIDC TOKEN MISSING | Het verzoek bevatte geen CI-token. Stuur het als Authorization: Bearer <token>. |
CI OIDC AUDIENCE INVALID | Het token is aangevraagd voor een andere audience. Vraag het aan voor https://dartastic.io, zoals het fragment doet. |
CI OIDC ISSUER NOT TRUSTED | De issuer van het token wordt niet vertrouwd voor deze organisatie. Voor Bitbucket, CircleCI, GitHub Enterprise Server of een zelfbeheerde GitLab voegt een eigenaar eerst de issuer toe. |
CI OIDC EXPIRED | Het token is verlopen voordat het werd uitgewisseld. Wissel het uit zodra de job het aanvraagt. |
CI OIDC TOKEN REPLAYED | Dit token is al uitgewisseld. Elk token wordt één keer uitgewisseld: wissel één keer per job uit. |
TRUSTED PUBLISHER NOT BOUND | Geen koppeling van deze organisatie noemt de repository van de job. Koppel die in “CI access” en controleer orgId in de workflow. |
TRUSTED PUBLISHER REPOSITORY MISMATCH | De koppeling noemt een andere repository of een ander project. De UUID’s en id’s moeten die van de job zelf zijn. |
TRUSTED PUBLISHER WORKFLOW MISMATCH | De job draaide vanuit een ander workflow- of pipelinebestand dan de koppeling toestaat. |
TRUSTED PUBLISHER ENVIRONMENT MISMATCH | De job draaide niet in de environment van de koppeling (of gebruikte, op CircleCI, de context ervan niet). |
TRUSTED PUBLISHER REF MISMATCH | De job draaide op een branch of tag die niet overeenkomt met het ref-patroon van de koppeling. |
TRUSTED PUBLISHER REPOSITORY ID MISMATCH | De repository is verwijderd en onder dezelfde naam opnieuw aangemaakt. Verwijder de koppeling en koppel de nieuwe repository. |
TRUSTED PUBLISHER AMBIGUOUS | Meer dan één koppeling komt overeen met de job. Maak ze specifieker (workflow, environment of ref), zodat er precies één overeenkomt. |
CI OIDC CLAIM MISSING | Het token mist een claim die de provider altijd meestuurt. Controleer of het token het eigen CI-token van de provider is, aangevraagd zoals het fragment doet. |
CI OIDC SSH RERUN | Een CircleCI-job is opnieuw met SSH uitgevoerd. Voer de job opnieuw uit zonder SSH. |
CI EXCHANGE RATE LIMITED | Te veel uitwisselingen voor deze repository of organisatie in korte tijd. Wissel één keer per job uit, wacht dan even en probeer het opnieuw. |
BOX STATE PUSH FAILED | De registry heeft het nieuwe token niet ontvangen. Voer de job opnieuw uit. |