global-credentials
Stack-weite Regeln für Zugangsdaten (API-Tokens, Personal Access Tokens, API-Keys,
sonstige Secrets): anlegen, benennen, Rechte, Ablage, aufräumen. Gilt für jede
Anwendung — Worker, Web-App, CI, MCP-Server.
Bewusst kein Inventar konkreter Tokens: das wäre volatil. Maßgeblich ist das
Token-Dashboard des jeweiligen Anbieters; dieser Skill regelt nur, wie es dort
aussehen soll.
Abgrenzung
global-mcp-framework — nur die MCP-eigene Secret-Mechanik
(MCP_AUTH_PASSWORD_HASH, Inbound vs. Outbound, „Authorization failed" nach
Consent). Secret-Namen und Token-Regeln kommen von hier.
global-git-conventions — Einrichtung von release-please samt Secret
RELEASE_PLEASE (references/automation.md); Zuschnitt des Tokens nach Regel 1
und 4.
Regeln
1. Ein Credential je Anwendung und Zweck
Build, Laufzeit und CI bekommen je ein eigenes Credential, nie zwischen Anwendungen
geteilt. Das gilt ausdrücklich auch für Cloudflare-Workers-Builds: je Worker ein
eigener Build-Token. Grund: Nur so lässt sich ein Token gezielt rotieren oder löschen,
ohne eine fremde Anwendung zu brechen, und „Last used" bleibt einer Anwendung
zuordenbar.
In Make ist die Anwendung die Aufgabe, nicht das einzelne Szenario: Szenarien mit
derselben Aufgabe (z. B. „Rechnungs-PDF an den Beleg hängen") teilen sich ein
Credential, jede andere Aufgabe bekommt ein eigenes.
2. Name beim Aussteller: <Zweck> · <Anwendung>
| Zweck |
Name beim Aussteller |
| Build (Cloudflare Workers Builds) |
Workers Builds · selectedleafs-app |
| CI (GitHub Actions) |
GitHub Actions · first-commerce-import-dashboard |
| Laufzeit (Worker liest Airtable) |
Worker · selectedleafs-app · Airtable |
| Make-Aufgabe (Szenarien schreiben in Airtable) |
make.com · Sync Invoice |
Ein dritter Teil · <Ziel> (das angesprochene System) ist optional, wenn der Zweck
allein nicht eindeutig ist. Wird eine Anwendung umbenannt, die Token-Namen bei allen
Ausstellern mitziehen.
Name beim Konsumenten: Liegt ein Credential beim Nutzer unter eigenem Namen
(Make-Schlüssel, Make-Verbindung mit API-Key oder Token), heißt es
<Aussteller> · <Anwendung> — spiegelbildlich zum Namen beim Aussteller: vorn steht
jeweils die Gegenseite, der zweite Teil ist auf beiden Seiten gleich.
| Beim Aussteller |
Beim Konsumenten |
Airtable-PAT make.com · Sync Invoice |
Make-Schlüssel Airtable · Sync Invoice |
Google-API-Key make.com · Store Places |
Make-Schlüssel Google · Store Places |
So zeigt jeder Name, wo das Credential rotiert wird, und das Gegenstück ist per Name
zu finden. Vorn nie die Datenquelle des Ablaufs (Lexware · … für einen
Airtable-Token) und nie die eigene Plattform (make.com · … in Make); hinten nie der
Produkt- oder API-Name statt der Anwendung (Google Place (New)). OAuth-Verbindungen,
die ein Konto autorisieren, fallen nicht darunter.
3. Secret-Namen im Code: <AUSSTELLER>_<TYP>
<AUSSTELLER> = wo das Credential ausgestellt und rotiert wird; <TYP> = die
Credential-Art. Nie die Anwendung im Secret-Namen — die steht nur im Namen beim
Aussteller (Regel 2).
- Ein Credential = ein Name über alle Konsumenten: jede Anwendung hat ihr eigenes
Credential (Regel 1), aber denselben Env-Namen. Bestehende Namen zeichengenau
übernehmen — ein falscher Name ist zur Laufzeit still
undefined.
- API-Key immer
_API_KEY; _TOKEN nur für Personal Access Tokens.
- Beispiele: Airtable-PAT
AIRTABLE_TOKEN, Resend RESEND_API_KEY, Google-API-Key
GOOGLE_API_KEY (Produkt-Qualifier nur zur Auflösung eines echten Doppels).
Suffix-Tabelle, Sonderfälle (Cloudflare-intern, GitHub-Secrets) und Begründung:
references/secret-names.md.
4. Minimale Rechte
Nur die betroffene Base, das betroffene Repo, das betroffene Konto. Typische
Mindest-Scopes:
| Credential |
Mindestrechte |
Ressource |
| Airtable-PAT |
data.records:read, bei Schreibzugriff zusätzlich data.records:write |
nur die eine Base |
| GitHub fine-grained PAT für release-please |
Contents + Pull requests, je Read and write |
nur die Repos der Anwendung |
| Cloudflare-Build-Token (Workers Builds) |
Standardrechte von Workers Builds; zusätzlich „Account · D1 · Edit", wenn der Deploy-Befehl D1-Migrationen anwendet |
nur das eine Konto |
Workers Builds unterstützt derzeit (Stand 25.10.2026) nur User-Tokens, keine
Account-Tokens.
5. Ablage
- Nie im Chat, nie im Repo, nie in Commit-Messages.
- Nur als Secret im Worker (Dashboard oder
wrangler secret put <NAME>) bzw. als
GitHub-Repository-Secret.
.dev.vars.example enthält nur Namen, keine Werte.
- Öffentliche Browser-Schlüssel (z. B. Google Maps) sind kein Secret: als Variable
setzen und beim Aussteller auf die Domain beschränken. Sie stehen ohnehin im
ausgelieferten Code; Schutz ist die Domain-Beschränkung.
6. Aufräumen
- Löschen: Tokens mit „Last used" älter als 90 Tage oder ohne zuordenbare Anwendung.
- Keine Tokens mit Rechten auf „alle Konten", wenn ein Konto reicht.
Checklisten
Neue Anwendung
- Zwecke festlegen (Build, Laufzeit, CI) — je Zweck ein eigenes Credential.
- Beim Aussteller anlegen: Name nach Regel 2, Rechte nach Regel 4; Make-Schlüssel
oder Make-Verbindung mit dem Spiegelnamen (Regel 2).
- Secret-Namen nach Regel 3; vorhandene Namen anderer Konsumenten übernehmen.
- Wert direkt als Worker- bzw. Repository-Secret setzen;
.dev.vars.example nur mit
Namen.
- Ersten Build und ersten Lauf prüfen.
Umbenennung einer Anwendung
- Alle Tokens der Anwendung bei jedem Aussteller umbenennen, Spiegelnamen beim
Konsumenten mit.
- Secrets am Ziel prüfen — ein unter neuem Namen neu angelegter Worker hat keine.
- Ersetzte Tokens löschen.
Rückbau einer Anwendung
- Alle Tokens der Anwendung beim Aussteller löschen, nicht nur das Secret.
- Worker- und Repository-Secrets entfernen.
- Anbieter-Dashboards gegenprüfen: kein Token mehr mit dem Anwendungsnamen.
1---2name: global-credentials3description: >-4 Stack-weite Regeln für Zugangsdaten (API-Tokens, PATs, API-Keys, Secrets) in Worker,5 Web-App, CI und MCP-Server: anlegen, beim Aussteller benennen, Secret-Namen im Code,6 minimale Rechte, Ablage, Aufräumen. IMMER laden, sobald ein Token oder Secret angelegt,7 benannt, gesetzt, rotiert oder gelöscht wird. Trigger: wrangler secret, GitHub-Secret,8 .dev.vars, Env-Variable, Scopes, neuer Worker, Make-Schlüssel, Make-Verbindung.9metadata:10 source: https://skillmd.com/skills/wemwi/global-credentials11 version: "1.1.0"12---1314# global-credentials1516Stack-weite Regeln für Zugangsdaten (API-Tokens, Personal Access Tokens, API-Keys,17sonstige Secrets): anlegen, benennen, Rechte, Ablage, aufräumen. Gilt für jede18Anwendung — Worker, Web-App, CI, MCP-Server.1920Bewusst **kein Inventar** konkreter Tokens: das wäre volatil. Maßgeblich ist das21Token-Dashboard des jeweiligen Anbieters; dieser Skill regelt nur, wie es dort22aussehen soll.2324## Abgrenzung2526- `global-mcp-framework` — nur die MCP-eigene Secret-Mechanik27 (`MCP_AUTH_PASSWORD_HASH`, Inbound vs. Outbound, „Authorization failed" nach28 Consent). Secret-Namen und Token-Regeln kommen von hier.29- `global-git-conventions` — Einrichtung von release-please samt Secret30 `RELEASE_PLEASE` (`references/automation.md`); Zuschnitt des Tokens nach Regel 131 und 4.3233## Regeln3435### 1. Ein Credential je Anwendung und Zweck3637Build, Laufzeit und CI bekommen je ein eigenes Credential, nie zwischen Anwendungen38geteilt. Das gilt ausdrücklich auch für Cloudflare-Workers-Builds: je Worker ein39eigener Build-Token. Grund: Nur so lässt sich ein Token gezielt rotieren oder löschen,40ohne eine fremde Anwendung zu brechen, und „Last used" bleibt einer Anwendung41zuordenbar.4243In Make ist die Anwendung die Aufgabe, nicht das einzelne Szenario: Szenarien mit44derselben Aufgabe (z. B. „Rechnungs-PDF an den Beleg hängen") teilen sich ein45Credential, jede andere Aufgabe bekommt ein eigenes.4647### 2. Name beim Aussteller: `<Zweck> · <Anwendung>`4849| Zweck | Name beim Aussteller |50|---|---|51| Build (Cloudflare Workers Builds) | `Workers Builds · selectedleafs-app` |52| CI (GitHub Actions) | `GitHub Actions · first-commerce-import-dashboard` |53| Laufzeit (Worker liest Airtable) | `Worker · selectedleafs-app · Airtable` |54| Make-Aufgabe (Szenarien schreiben in Airtable) | `make.com · Sync Invoice` |5556Ein dritter Teil `· <Ziel>` (das angesprochene System) ist optional, wenn der Zweck57allein nicht eindeutig ist. Wird eine Anwendung umbenannt, die Token-Namen bei allen58Ausstellern mitziehen.5960**Name beim Konsumenten:** Liegt ein Credential beim Nutzer unter eigenem Namen61(Make-Schlüssel, Make-Verbindung mit API-Key oder Token), heißt es62`<Aussteller> · <Anwendung>` — spiegelbildlich zum Namen beim Aussteller: vorn steht63jeweils die Gegenseite, der zweite Teil ist auf beiden Seiten gleich.6465| Beim Aussteller | Beim Konsumenten |66|---|---|67| Airtable-PAT `make.com · Sync Invoice` | Make-Schlüssel `Airtable · Sync Invoice` |68| Google-API-Key `make.com · Store Places` | Make-Schlüssel `Google · Store Places` |6970So zeigt jeder Name, wo das Credential rotiert wird, und das Gegenstück ist per Name71zu finden. Vorn nie die Datenquelle des Ablaufs (`Lexware · …` für einen72Airtable-Token) und nie die eigene Plattform (`make.com · …` in Make); hinten nie der73Produkt- oder API-Name statt der Anwendung (`Google Place (New)`). OAuth-Verbindungen,74die ein Konto autorisieren, fallen nicht darunter.7576### 3. Secret-Namen im Code: `<AUSSTELLER>_<TYP>`7778- `<AUSSTELLER>` = wo das Credential ausgestellt und rotiert wird; `<TYP>` = die79 Credential-Art. Nie die Anwendung im Secret-Namen — die steht nur im Namen beim80 Aussteller (Regel 2).81- **Ein Credential = ein Name über alle Konsumenten:** jede Anwendung hat ihr eigenes82 Credential (Regel 1), aber denselben Env-Namen. Bestehende Namen zeichengenau83 übernehmen — ein falscher Name ist zur Laufzeit still `undefined`.84- API-Key immer `_API_KEY`; `_TOKEN` nur für Personal Access Tokens.85- Beispiele: Airtable-PAT `AIRTABLE_TOKEN`, Resend `RESEND_API_KEY`, Google-API-Key86 `GOOGLE_API_KEY` (Produkt-Qualifier nur zur Auflösung eines echten Doppels).8788Suffix-Tabelle, Sonderfälle (Cloudflare-intern, GitHub-Secrets) und Begründung:89`references/secret-names.md`.9091### 4. Minimale Rechte9293Nur die betroffene Base, das betroffene Repo, das betroffene Konto. Typische94Mindest-Scopes:9596| Credential | Mindestrechte | Ressource |97|---|---|---|98| Airtable-PAT | `data.records:read`, bei Schreibzugriff zusätzlich `data.records:write` | nur die eine Base |99| GitHub fine-grained PAT für release-please | `Contents` + `Pull requests`, je Read and write | nur die Repos der Anwendung |100| Cloudflare-Build-Token (Workers Builds) | Standardrechte von Workers Builds; zusätzlich „Account · D1 · Edit", wenn der Deploy-Befehl D1-Migrationen anwendet | nur das eine Konto |101102Workers Builds unterstützt derzeit (Stand 25.10.2026) nur User-Tokens, keine103Account-Tokens.104105### 5. Ablage106107- Nie im Chat, nie im Repo, nie in Commit-Messages.108- Nur als Secret im Worker (Dashboard oder `wrangler secret put <NAME>`) bzw. als109 GitHub-Repository-Secret.110- `.dev.vars.example` enthält nur Namen, keine Werte.111- Öffentliche Browser-Schlüssel (z. B. Google Maps) sind kein Secret: als Variable112 setzen und beim Aussteller auf die Domain beschränken. Sie stehen ohnehin im113 ausgelieferten Code; Schutz ist die Domain-Beschränkung.114115### 6. Aufräumen116117- Löschen: Tokens mit „Last used" älter als 90 Tage oder ohne zuordenbare Anwendung.118- Keine Tokens mit Rechten auf „alle Konten", wenn ein Konto reicht.119120## Checklisten121122**Neue Anwendung**1231. Zwecke festlegen (Build, Laufzeit, CI) — je Zweck ein eigenes Credential.1242. Beim Aussteller anlegen: Name nach Regel 2, Rechte nach Regel 4; Make-Schlüssel125 oder Make-Verbindung mit dem Spiegelnamen (Regel 2).1263. Secret-Namen nach Regel 3; vorhandene Namen anderer Konsumenten übernehmen.1274. Wert direkt als Worker- bzw. Repository-Secret setzen; `.dev.vars.example` nur mit128 Namen.1295. Ersten Build und ersten Lauf prüfen.130131**Umbenennung einer Anwendung**1321. Alle Tokens der Anwendung bei jedem Aussteller umbenennen, Spiegelnamen beim133 Konsumenten mit.1342. Secrets am Ziel prüfen — ein unter neuem Namen neu angelegter Worker hat keine.1353. Ersetzte Tokens löschen.136137**Rückbau einer Anwendung**1381. Alle Tokens der Anwendung beim Aussteller löschen, nicht nur das Secret.1392. Worker- und Repository-Secrets entfernen.1403. Anbieter-Dashboards gegenprüfen: kein Token mehr mit dem Anwendungsnamen.