Erstellen Sie ein Servicekonto
Ziel
So erstellen Sie ein Servicekonto mit dem Unternehmensverwaltungs-Tool.
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 Servicekonto 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 das client_secret verlieren, empfiehlt Procore, die folgenden Schritte auszuführen, um ein neues Servicekonto zu erstellen.
- Neue Servicekonten 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
- Navigieren Sie zum Administrations-Tool auf Unternehmensebene.
- Klicken Sie unter „Unternehmenseinstellungen“ auf Servicekonten.
- Klicken Sie auf der Seite Servicekonten auf + Neu .
- Geben Sie einen „App-Typ“ an. Wenn Sie dieses Servicekonto mit einer bestimmten Marketplace-App verwenden, wählen Sie die Marketplace- Option und wählen Sie die entsprechende App aus der Dropdown-Liste aus. Wählen Sie andernfalls Benutzerdefiniert aus .
- Geben Sie einen Namen für Ihr neues Servicekonto ein und klicken Sie auf Erstellen. Die client_id und das client_secret für das Servicekonto werden generiert und stehen für Aufrufe an den /oauth/token-Endpunkt der Procore-API zur Verfügung.
- Konfigurieren von Servicekontoberechtigungen. Da das Servicekonto bei der ersten Erstellung keine Berechtigungen auf Unternehmensebene hat, müssen Sie die entsprechenden Berechtigungen für das Servicekonto festlegen, bevor Sie es für den Zugriff auf die Procore-API verwenden.
Wichtig
Beachten Sie, dass Sie mit einem Servicekonto ohne Berechtigungen ('Keine') möglicherweise ein OAuth 2.0-Zugriffstoken generieren können, dieses Token jedoch nicht für erfolgreiche Aufrufe der Procore-API funktioniert. Daher müssen Sie die richtigen Berechtigungen für das Servicekonto festlegen, bevor es mit dem Procore API zuzugreifen.