---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Verwenden Sie einen externen OAuth-Anbieter

# Verwenden Sie einen externen OAuth-Anbieter {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Jede Client-Anwendung muss sich bei der Instanz registrieren, um an der OAuth-Autorisierung teilzunehmen.

## Vorbereitungen

Erforderliche Rolle: Administrator

## Warum und wann dieser Vorgang ausgeführt wird

Hinweis:  
ServiceNowUnterstützt nur externe OAuth-Anbieter, um Anforderungen von zu autorisieren ServiceNowAn Drittpartei-APIs.
Sie können beispielsweise in einen Drittpartei-Kalenderservice integrieren, der OAuth 2,0-Zugriffstoken erfordert, um die geplanten Ereignisse eines Anwenders zu lesen und Ereignisse zu erstellen. Konfigurieren Sie den Kalenderservice als externen OAuth-Anbieter. Mit dieser Konfiguration können Sie ein Zugriffstoken vom Kalenderservice abrufen und dann das Token verwenden, um Anforderungen für den Service von zu stellen ServiceNow.

## Prozedur

1. Navigieren zu AlleSystem-OAuthApplikationsregistrierung Und klicken Sie dann auf Neu .
2. Klicken Sie auf der Interceptor-Seite auf Stellen Sie eine Verbindung zu einem externen OAuth-Anbieter her Und füllen Sie dann das Formular aus.  
   {#t_UseAThirdPartyOAuthProvider__table_sgc_qqv_yq__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Name | Ein eindeutiger Name, der die Anwendung identifiziert, auf die zugegriffen werden soll. |
   | Client-ID | Die eindeutige ID der Anwendung. Die Instanz verwendet die Client-ID, wenn ein Zugriffstoken angefordert wird. Sie müssen die Client-ID vom Autorisierungsserver abrufen. |
   | Geheimer Clientschlüssel | \[Erforderlich\] die Zeichenfolge des gemeinsamen geheimen Geheimnisses, die die Instanz und die Anwendung verwenden, um die Kommunikation miteinander zu autorisieren. Wenn Sie nicht den richtigen geheimen Client eingeben, werden keine Token ausgegeben. |
   | OAuth-API-Skript | Mit dieser Option können Sie auf eine geänderte OAuthUtil-Skripteinbindung verweisen. Kopieren Sie die standardmäßige OAuthUtil-Skripteinbindungsdatei, und benennen Sie sie um, und ändern Sie diese Version dann für bestimmte Anforderungen und Antworten an Ihren Drittanbieter-OAuth-Anbieter. Der geänderte Skriptname muss das Präfix haben OAuth . Siehe [OAuthUtil](https://servicenow-prod.fluidtopics.net/Z~TBsSh6LUrqWJyn5wYVyw#c_OAuthUtilScriptInclude "Die OAuthUtil Die Skripteinbindung ändert Anforderungsparameter und analysiert die Tokenantwort während der Laufzeit.")Um den erforderlichen Textparameter in der richtigen Methode hinzuzufügen. |
   | Logo-URL | Die URL, die ein Bild enthält, das als Anwendungslogo verwendet werden soll. |
   | Standardgewährungstyp | Der Typ der Gewährung: * Autorisierungscode : Der Code, der dem Client gewährt wird, um ein Zugriffstoken zu erhalten, das dann verwendet wird, um Zugriff auf die Ressource zu erhalten. Wenn Sie diese Option auswählen, benötigen Sie eine Autorisierungs-URL (die URL des Autorisierungsservers). * Passwort-Anmeldeinformationen des Ressourcenbesitzers : Der Anwendername und das Passwort des Anwenders, der versucht, Zugriff auf die Ressource zu erhalten. * Client-Anmeldeinformationen : Die Client-ID und der geheime Client-Schlüssel, die beide zum Abrufen des Zugriffstoken verwendet werden. Diese Methode stellt keine Aktualisierungstoken bereit. * JWT-Bearer : Ein Autorisierungsserver validiert ein JWT-Token, mit dem Identitäts- und Sicherheitsinformationen über Sicherheitsdomänen hinweg freigegeben werden können. * SAML2-Bearer : Generiert die SAML2-Assertion und tauscht die Assertion dann für die Zugriffstoken mit dem Provider aus. Hinweis: Für ausgehende Anforderung an SuccessFactorsVerwenden Sie SAML2-Bearer Als Standardgewährungstyp. {#t_UseAThirdPartyOAuthProvider__ul_ln4_4pg_nwb} |
   | Lebensdauer von Aktualisierungstoken | Die Lebensdauer des Aktualisierungstoken in Sekunden. |
   | Zugänglich von | Der Anwendungsbereich, von dem aus auf diese Registrierung zugegriffen werden kann. |
   | Aktiv | Ein Kontrollkästchen, das angibt, dass die Anwendungsregistrierung aktiv ist. |
   | Autorisierungs-URL | Wenn Sie den Berechtigungstyp für den Autorisierungscode verwenden, die URL des Endpunkts zur Autorisierung des Anwenders. Wenn Sie auf eine andere zugreifen ServiceNowInstanz, anfügen `/oauth_auth.do `An die URL. |
   | Token-URL | Der Speicherort des Tokenendpunkts, den die Instanz zum Abrufen und Aktualisieren von Token verwendet. Wenn Sie auf eine andere zugreifen ServiceNowInstanz, anfügen `/oauth_Token.do `An die URL. |
   | Umleitungs-URL | Der Anwendungsendpunkt, der den Autorisierungscode empfängt. Lassen Sie das Feld leer, damit die Instanz die URL automatisch generiert. Wenn Sie auf eine andere zugreifen ServiceNowInstanz, anfügen `/oauth_redirect.do `An die URL. |
   | Token-Sperr-URL | Der Speicherort des Endpunkts, den die Instanz zum Widerrufen des Tokens verwendet. Wenn Sie auf eine andere Instanz zugreifen, fügen Sie an `/oauth_revoke.do `An die URL. |
   | Kommentare | Zusätzliche Informationen, die der Anwendung zugeordnet werden sollen. |
   | Eingebettete Listen ||
   | OAuth-Einheitenprofile | Die Profile, die dem OAuth-Anbieter zugeordnet sind. Das Profil enthält den Gewährungstyp. Klicken Sie auf den Profilnamen, um zu wechseln [Das Formular „OAuth-Entitätsprofil"](https://servicenow-prod.fluidtopics.net/uBjvPc~rJfqrNUvvU0GMcw "Ein OAuth-Profil enthält den Gewährungstyp, den der externe OAuth-Anbieter benötigt, um Zugriff auf die eingeschränkte Ressource zu erhalten."). |
   | OAuth-Einheitenumfänge | Die Entitätsbereiche, die dem OAuth-Anbieter zugeordnet sind. Der Umfang gibt die Services an, auf die die Anwendung Zugriff hat. Klicken Sie auf den Bereichsnamen, um zu wechseln [Das Formular „OAuth-Entitätsbereich"](https://servicenow-prod.fluidtopics.net/yS5dc66vs9GPwGSIIeMlaQ "Geben Sie die OAuth-Umfänge an, die Sie vom Anbieter erhalten. Umfänge können eine beliebige vom Anbieter angegebene Zugriffsebene sein, z. B. Lesen, Schreiben oder eine beliebige Zeichenfolge, einschließlich einer URL."). |
   [ ]

   {#t_UseAThirdPartyOAuthProvider__table_sgc_qqv_yq}
3. Klicken Sie auf Absenden. Der Datensatz wird in der Tabelle „Anwendungsregistrierungen" \[oauth_Entität\] gespeichert.  
   Das System erstellt einen Datensatz in der Tabelle „Anwendungsregistrierungen" \[oauth_Entität\] vom Typ „OAuth-Anbieter". Die Instanz generiert auch automatisch ein Standardprofil mit dem angegebenen Gewährungstyp, jedoch ohne Umfänge.

## Nächste Maßnahme

Sie können [Erstellen Sie zusätzliche Profile](https://servicenow-prod.fluidtopics.net/uBjvPc~rJfqrNUvvU0GMcw "Ein OAuth-Profil enthält den Gewährungstyp, den der externe OAuth-Anbieter benötigt, um Zugriff auf die eingeschränkte Ressource zu erhalten."), Jeweils mit Umfängen.
* **[OAuth-Profile und -Umfänge](https://servicenow-prod.fluidtopics.net/AfjXbEEMrcqM~rLI61bc4w)**   
  Im OAuth-Anbieterszenario geben Profile und Umfänge den Gewährungstyp, Autorisierungstyp und die Zugriffsebene an.

