Zu Hauptinhalten wechseln
Procore

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

 Auslaufen traditioneller Servicekonten

Alle traditionellen Servicekonten werden am 31. Dezember 2024auslaufen.

Traditionelle Servicekonten wurden am 9. Dezember 2021 eingestellt. Ab dem 1. Oktober 2024 werden wir die Erstellung neuer Konten für traditionelle Dienstleistungen nicht mehr zulassen. Bestehende traditionelle Servicekonten sind bis zum 31. Dezember 2024 weiterhin funktionsfähig.

In Übereinstimmung mit diesem Zeitplan müssen Entwickler von Datenverbindungsanwendungen, die derzeit herkömmliche Dienstkonten verwenden, ihre Anwendungen aktualisieren,um Dateiname="">Entwicklerverwaltete Dienstkonten zu verwenden<a target="_blank" title=" " href.path="//faq/what-is-developer-managed-service-account" href., und die Kunden müssen diese aktualisierten Anwendungen vor dem Ablaufdatum installieren. Alle Datenverbindungsanwendungen, die bis zum Ablaufdatum nicht migriert wurden, funktionieren nicht mehr. Alle auf dem Procore-App Marketplace aufgeführten Anwendungen, die keine unterstützte Methode für den Zugriff auf die Procore API verwenden, werden bis zum Ablaufdatum entfernt. Siehe Migration von Datenverbindungsanwendungen zur Verwendung von DMSAs für zusätzliche Informationen.

Ziel

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

Hintergrund

Mit Servicekonten 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 Servicekontos wird eine eindeutige client_id und client_secret is 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 Dienstkonten werden standardmäßig ohne Berechtigungen ('Keine') erstellt. Informationen zum Ändern dieser Berechtigungen finden Sie unter Konfigurieren von Servicekontoberechtigungen.
  • 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