Zu Hauptinhalten wechseln
Procore

Zurücksetzen des geheimen Clientschlüssels für ein Servicekonto

Ziel

So setzen Sie den geheimen Clientschlüssel für ein Servicekonto mithilfe des Unternehmensverwaltungs-Tools zurück.

Hintergrund

Mit Dienstkonten können Sie Integrationen unterstützen, die den Gewährungsablauf für Clientanmeldeinformationen erfordern, wie in der IETF OAuth 2.0 Framework Specification definiert. In diesem Szenario benötigen Anwendungen eine Möglichkeit, ein OAuth 2.0-Zugriffstoken außerhalb des Kontexts eines bestimmten Procore-Benutzers abzurufen. OAuth 2.0 stellt zu diesem Zweck den Gewährungstyp Clientanmeldeinformationen bereit. Beim Erstellen eines neuen Servicekontos wird eine eindeutige client_id und client_secret generiert. Informationen zum Implementieren des Gewährungsablaufs für Clientanmeldeinformationen in einer Anwendung finden Sie unter OAuth 2.0 mit Clientanmeldeinformationen in unserem Entwicklerportal.

Wichtige Hinweise

  • Erforderliche Benutzerberechtigung:
    • Berechtigungen auf 'Admin'-Ebene für das Administrations-Tool des Unternehmens.
  • Überlegungen zum Zugriff:
    • Ein neues Servicekonto besteht aus:
      • client_id. Das Identifizierungsmerkmal für das Servicekonto.
      • client_secret . Das Geheimnis ist ein zufällig generierter Code, der vom Dienstkonto verwendet wird. Es ist nur zum Zeitpunkt der Kontoerstellung für Sie sichtbar. Sie können das client_secret notieren und dann an einem sicheren Ort speichern, falls Sie es in Zukunft als Referenz benötigen.
        Wichtig! Wenn Sie aus irgendeinem Grund den geheimen Clientschlüssel verlieren, empfiehlt Procore, ein neues Servicekonto zu erstellen.
      • Neue Servicekonten werden standardmäßig ohne Berechtigungen ('Keine') erstellt. Informationen zum Ändern dieser Berechtigungen finden Sie unter Konfigurieren von Servicekontenberechtigungen.
  • Wichtige Überlegungen zum Unternehmensadressbuch:
    • Nachdem Sie ein Servicekonto erstellt haben, darf die zugehörige E-Mail-Adresse im Unternehmensadressbuch nicht geändert werden. Wenn Sie die E-Mail-Adresse des Servicekontos ändern, ist das Servicekonto nicht mehr funktionsfähig.
    • Der Servicekontokontakt kann nicht mehr als einem Unternehmensadressbuch hinzugefügt werden (nur dem, in dem er erstellt wurde), oder er funktioniert nicht mehr.

Schritte

 Wichtig
Beachten Sie, dass durch das Zurücksetzen des geheimen Clientschlüssel alle Berechtigungen und Projektmitgliedschaften für das ausgewählte Servicekonto zurückgesetzt werden.
  1. Navigieren Sie zum Administrations-Tool auf Unternehmensebene.
  2. Klicken Sie unter „Unternehmenseinstellungen“ auf Servicekonten.
  3. Suchen Sie das Servicekonto, für das Sie den geheimen Clientschlüssel zurücksetzen möchten, und klicken Sie auf Anzeigen.
  4. Klicken Sie auf Schlüssel zurücksetzen, um den geheimen Clientschlüssel für das ausgewählte Servicekonto zurückzusetzen.

reset-client-secret.png

  1. Klicken Sie auf Weiter, um Ihre Aktion zu bestätigen.

reset-client-secret-continue.png