Authentifizierung und SchlüsselAPI
Die akzeptiertAPI Gateway bereichsgebundene SchlüsselCHAMPREPAPI für Serverintegrationen und Automatisierung. Zur Verwaltung von Schlüsseln werden browserbasierte Kontositzungen verwendet, jedoch sollte eine benutzerdefinierte Integration ihre Dienstanfragen mit einem APISchlüssel authentifizieren.
Schlüssel erstellen
Abschnitt betitelt „Schlüssel erstellen“- Öffnen API Schlüssel.
- Wählen Sie einen Namen, der die Arbeitslast und die Umgebung eindeutig identifiziert.
- Wählen Sie für jeden Dienst eine Zugriffsebene aus und schränken Sie diese anschließend auf die Bereiche ein, die die Workload benötigt.
- Fügen Sie eine IP-Whitelist hinzu, wenn die Workload über stabile ausgehende Adressen verfügt.
- Kopieren Sie den Schlüssel einmalig und speichern Sie ihn in einem Secret Manager oder einem Schlüsselbund.
Erstellen Sie nicht für jede Anwendung einen einzigen Schlüssel mit weitreichendem Geltungsbereich. Getrennte Schlüssel machen die Rotation, die Audit-Prüfung und die Reaktion auf Vorfälle sicherer.
Senden Sie die Anmeldedaten
Abschnitt betitelt „Senden Sie die Anmeldedaten“Authorization: Bearer YOUR_API_KEYFür Shell-Beispiele speichern Sie den Wert in einer Umgebungsvariablen:
curl --fail-with-body \ --header "Authorization: Bearer $CHAMPREP_TOKEN" \ https://api.champrep.com/v1/auth/whoamiFügen Sie einen Schlüssel nicht in eine URL, einen Abfrageparameter, ein Frontend-JavaScript-Bundle, eine mobile Anwendung, eine Protokollzeile oder ein Analyseereignis ein.
Gültigkeitsbereichskatalog
Abschnitt betitelt „Gültigkeitsbereichskatalog“Der Bildschirm API„Schlüssel“ gruppiert die Dienste in vier Bereiche: Arbeitsbereich, Kommunikation, Entwickler und Admin. Wählen Sie für jeden Dienst eine Zugriffsebene aus und fügen Sie anschließend einzelne Bereiche hinzu oder entfernen Sie diese, falls die Arbeitslast eine engere Eingrenzung erfordert:
- Keine: Der Schlüssel kann den Dienst nicht nutzen.
- Lesen: die Bereiche in der Spalte „Lesen“.
- Lesen & Schreiben: Lesen sowie die Bereiche in der Spalte „Schreiben“.
- Admin: alle oben genannten Bereiche sowie die in der Spalte „Admin“ aufgeführten Bereiche für die Dienste, die über solche verfügen.
Markierte Bereiche Opt-in werden niemals nach Stufe ausgewählt. Markieren Sie sie anhand ihres Namens. Ein Dienst, der in Ihrem Tarif nicht enthalten ist, wird gesperrt angezeigt, mit einem Link zum Upgrade. Der Bildschirm zeigt stets den aktuell aktiven Katalog an.
Arbeitsbereich
Abschnitt betitelt „Arbeitsbereich“| Dienst | Lesen | Schreiben | Admin |
|---|---|---|---|
| Drive | drive:read | drive:write, drive:delete | — |
| Dokumente | docs:read, docs:export | docs:write, docs:share, docs:delete | — |
| Tabellen | sheets:read, sheets:export | sheets:write, sheets:share, sheets:delete | — |
| Notes | notes:read | notes:write | — |
| Calendar | calendar:read | calendar:write | — |
| Contacts | contacts:read | contacts:write | — |
| Work | work:read | work:write, work:delete | — |
| Forms | forms:read | forms:write | — |
| Invoice | invoice:read | invoice:write, invoice:send, invoice:delete | — |
| Organigramme | charts:read | charts:write, charts:delete | — |
| Learn | courses:read | courses:write | — |
| Schule LMS | Noch nicht über einen SchlüsselAPI verfügbar |
Kommunikation
Abschnitt betitelt „Kommunikation“| Dienst | Lesen | Schreiben | Admin |
|---|---|---|---|
mail:read | mail:write, mail:send | — | |
| Chat | chat:read | chat:write | — |
| Meet | meet:read | meet:write | — |
| RTC | In Kürze verfügbar. RTC verwendet eigene Projekt-SchlüsselAPI |
Entwickler
Abschnitt betitelt „Entwickler“| Dienst | Lesen | Schreiben | Admin |
|---|---|---|---|
| CHAMPREP Code | code:read_api, code:read_repository, code:read_registry, code:read_package_registry | code:write_repository, code:write_registry, code:write_package_registry | code:api; Opt-in code:admin_mode |
| CHAMPREP QA | qa:read | qa:write | — |
| Runner-Farm | runner_farm:read | runner_farm:write | — |
| CLI | — | cli:use | — |
| CHAMPREP AI | — | ai:chat; Opt-in ai:actions, ai:agent | — |
| Dienst | Lesen | Schreiben | Admin |
|---|---|---|---|
| Business | business:read | — | business:manage |
| Abrechnung | billing:read | — | billing:manage |
| Entwickler API | api:read | — | api:manage, webhooks:manage |
| Profil | users:read | — | — |
Die Plattformverwaltung steht einem SchlüsselAPI niemals zur Verfügung; hierfür ist ein angemeldeter Administrator erforderlich.
Notes für bestimmte Bereiche
Abschnitt betitelt „Notes für bestimmte Bereiche“- CHAMPREP Code. Jedes
code:Der Geltungsbereich entspricht dem gleichnamigen persönlichen Zugriffstoken-Geltungsbereich in CHAMPREP„Code“, und „Code“ überprüft diesen an jedem Endpunkt.code:apibieten vollen Lese- und Schreibzugriff auf alles, worauf Ihr Konto in Code zugreifen kann, und liegen somit auf der Admin-Ebene; bevorzugen Sie die enger gefassteread_undwrite_Gültigkeitsbereiche. Endpunkte zur Code-Verwaltung benötigen einen Schlüssel, dercode:admin_modenach Namen sowie ein Konto, das als Code-Administrator fungiert. - Runner-Farm.
runner_farm:writeregistriert und verwaltet Runner, Pools und Verbindungen. Sie kauft niemals Guthaben und ändert keine Zahlungseinstellungen, und sie stellt niemals ein Connector-Geheimnis oder ein Runner-Token aus, ersetzt diese oder testet sie. Für diese Aktionen ist eine angemeldete Person erforderlich. - Dokumente und Tabellen. Freigabe (Mitarbeiter, Linkfreigabe, Veröffentlichung), dauerhafte Löschung oder Bereinigung sowie Export erfordern jeweils einen eigenen Geltungsbereich. Ein Schlüssel mit nur
docs:writeodersheets:writekönnen Inhalte bearbeiten, diese jedoch nicht freigeben, löschen oder exportieren. - CHAMPREP AI.
ai:agentermöglichen es, CLI KI-Agent verwenden lokale Tools und umfassenai:chat.ai:actionsgenehmigt oder lehnt Aktionen ab, die die KI in Ihren DienstenCHAMPREP vorschlägt, und nichts anderes.
Der Platzhalter-Gültigkeitsbereich
Abschnitt betitelt „Der Platzhalter-Gültigkeitsbereich“Der Platzhalter-Gültigkeitsbereich * (vollständiger Zugriff) decken alle in Ihrem Tarif enthaltenen Dienste ab, einschließlich CHAMPREPCode, Runner Farm und Docs. CHAMPREPCode behandelt dies als
code:api, d. h. vollen Lese- und Schreibzugriff. Nicht enthalten sind
ai:agent oder code:admin_mode; diese müssen stets namentlich ausgewählt werden.
Reservieren Sie den Platzhalter für streng kontrollierte administrative Integrationen und schränken Sie bestehende Vollzugriffsschlüssel ein, wenn diese die neueren Dienste nicht benötigen. Ein Gültigkeitsbereich erlaubt eine Kategorie von Aktionen; er hat keinen Vorrang vor Plan-, Rollen-, Organisations- oder Ressourcenberechtigungen.
Lebenszyklus von Schlüsseln
Abschnitt betitelt „Lebenszyklus von Schlüsseln“
Rotieren
Abschnitt betitelt „Rotieren“Erstellen oder generieren Sie einen Ersatzschlüssel neu, stellen Sie ihn bereit, vergewissern Sie sich, dass die Workload ihn verwendet, und widerrufen Sie anschließend den bisherigen Schlüssel. Vermeiden Sie eine Rotation, bei der eine unbeaufsichtigte Workload ohne gültige Anmeldedaten zurückbleibt.
Widerrufen
Abschnitt betitelt „Widerrufen“Entziehen Sie einen Schlüssel unverzüglich, wenn er offengelegt wurde, auf ein nicht vertrauenswürdiges System kopiert wurde oder nicht mehr zu einer aktiven Arbeitslast gehört. Ein widerrufener Schlüssel sollte 401 und dürfen nicht unbegrenzt wiederholt werden.
Überblick
Abschnitt betitelt „Überblick“Überprüfen Sie regelmäßig Schlüsselnamen, Gültigkeitsbereiche, IP-Einschränkungen, Informationen zur letzten Nutzung sowie die Audit-Aktivitäten. Löschen Sie ungenutzte Schlüssel, anstatt sie für ein mögliches zukünftiges Skript aufzubewahren.
Anmeldung über den Browser und AnmeldungCLI
Abschnitt betitelt „Anmeldung über den Browser und AnmeldungCLI“champrep auth login verwendet einen Browser-Genehmigungsablauf für eine Person an einem Terminal.
champrep auth token speichert einen bereichsgebundenen APISchlüssel für die Automatisierung. Die CLI schütztCLI gespeicherte Anmeldedaten mit dem Schlüsselbund des Betriebssystems und sendet alle netzwerkgebundenen Befehle über das Gateway.
Siehe CLI Authentifizierung und API Schlüssel für die AutomatisierungCLI für diese Arbeitsabläufe.