--- sourceDocument: Xanadu-API-Referenz sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-API-Referenz ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Externe OAuth-Provider verwenden # Externe OAuth-Provider verwenden {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer Jede Client-Anwendung muss bei der Instanz registriert sein, um an der OAuth-Autorisierung teilnehmen zu können. ## Vorbereitungen Erforderliche Rolle: admin ## Warum und wann dieser Vorgang ausgeführt wird Hinweis: ServiceNow unterstützt nur externe OAuth-Provider bei der Genehmigung von Anfragen von ServiceNow an Drittanbieter-APIs. Zum Beispiel möchten Sie unter Umständen einen Drittanbieter-Kalender-Service integrieren, für den OAuth 2.0-Zugriffstoken erforderlich sind, damit die geplanten Ereignisse eines Benutzers abgerufen und neue Ereignisse erstellt werden können. Konfigurieren Sie den Kalender-Service als einen externen OAuth-Provider. Mit dieser Konfiguration können Sie ein Zugriffstoken vom Kalender-Service abrufen und dann das Token verwenden, um Anforderungen von ServiceNow aus an den Service zu senden. ## Prozedur 1. Navigieren zu AlleSystem-OAuthApplikationsregistrierung und klicken Sie dann auf Neu. 2. Klicken Sie auf der Interceptor-Seite auf Verbindung zu einem fremden OAuth-Provider herstellen, 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 angibt, 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. | | Client-Secret | \[Erforderlich\] Die gemeinsam genutzte geheime Zeichenfolge, mit der die Instanz und die Anwendung die Kommunikation miteinander autorisieren. Wenn Sie nicht den richtigen Client-Secret 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 dann diese Version für bestimmte Anforderungen und Antworten entsprechend Ihrem OAuth-Drittpartei-Provider. Der geänderte Skriptname muss das Präfix OAuthhaben. Siehe [OAuthUtil](https://servicenow-prod.fluidtopics.net/Sgp1yudpFVfhJ_SIC1W8Zw#c_OAuthUtilScriptInclude "Die OAuthUtil-Skripteinbindung ändert Anforderungsparameter und analysiert die Tokenantwort während der Laufzeit.") zum Hinzufügen des erforderlichen Textkörperparameters in der richtigen Methode. | | Logo-URL | Die URL, die ein Bild enthält, das als Anwendungslogo verwendet werden soll. | | Standardgewährungstyp | Typ des 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). * Anmeldeinformationen des Ressourcenbesitzers: Der Benutzername und das Passwort des Benutzers, der versucht, auf die Ressource zuzugreifen. * Client-Anmeldeinformationen: Die Client-ID und der Client-Secret, die beide zum Abrufen des Zugriffstokens verwendet werden. Bei dieser Methode werden keine Aktualisierungstoken bereitgestellt. * JWT Bearer: Ein Autorisierungsserver validiert ein JWT-Token, das die Weitergabe von Identitäts- und Sicherheitsinformationen zwischen Sicherheitsdomänen ermöglicht. * SAML2-Bearer: Generiert die SAML2-Assertion und tauscht die Assertion dann für die Zugriffstoken mit dem Anbieter aus. Hinweis: Verwenden Sie für die ausgehende Anforderung an SuccessFactors den SAML2-Bearer als standardmäßigen Gewährungstyp. {#t_UseAThirdPartyOAuthProvider__ul_ln4_4pg_nwb} | | Lebensdauer von Aktualisierungstoken | Die Lebensdauer des Aktualisierungstokens in Sekunden. | | Zugänglich von | Der Anwendungsbereich, von dem aus auf diese Registry zugegriffen werden kann. | | Aktiv | Eine Checkbox, die angibt, dass die Anwendungs-Registry aktiv ist. | | Autorisierungs-URL | Wenn Sie den Gewährungstyp „Autorisierungscode" verwenden, die URL des Endpunkts zum Autorisieren des Benutzers. Wenn Sie auf eine andere ServiceNow-Instanz zugreifen, fügen Sie `/oauth_auth.do` an die URL an. | | Token-URL | Die Position des Tokenendpunkts, den die Instanz zum Abrufen und Aktualisieren von Token verwendet. Wenn Sie auf eine andere ServiceNow-Instanz zugreifen, fügen Sie `/oauth_token.do` an die URL an. | | 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 ServiceNow-Instanz zugreifen, fügen Sie `/oauth_redirect.do` an die URL an. | | Token-Sperr-URL | Die Position des Endpunkts, den die Instanz verwendet, um das Token zu widerrufen. Wenn Sie auf eine andere Instanz zugreifen, fügen Sie `/oauth_revoke.do` an die URL an. | | Anmerkungen | Die der Anwendung zuzuordnenden Informationen. | | Eingebettete Listen || | OAuth-Einheitenprofile | Die mit dem OAuth-Provider verknüpften Profile. Das Profil enthält den Gewährungstyp. Klicken Sie auf den Profilnamen, um zum [Formular „OAuth-Einheitenprofil"](https://servicenow-prod.fluidtopics.net/773PvCmHjWxh~4PdlLQ_cQ "Ein OAuth-Profil enthält den Gewährungstyp, den der externe OAuth-Provider benötigt, um Zugriff auf die eingeschränkte Ressource zu erhalten.") zu gelangen. | | OAuth-Einheitenumfänge | Die mit dem OAuth-Provider verknüpften Einheitenumfänge. Der Bereich gibt die Services an, auf die die Anwendung Zugriff hat. Klicken Sie auf den Namen des Bereichs, um zum [Formular „OAuth-Einheitenumfang"](https://servicenow-prod.fluidtopics.net/QWqvGY1LQdKavKi_cwEKXg "Geben Sie die OAuth-Bereiche an, die Sie vom Provider erhalten. Bereiche können jede vom Provider angegebene Zugriffsebene sein, z. B. „Lesen“, „Schreiben“ oder eine beliebige Zeichenfolge, einschließlich einer URL.") zu gelangen. | [ ] {#t_UseAThirdPartyOAuthProvider__table_sgc_qqv_yq} 3. Klicken Sie auf Absenden. Der Datensatz wird in der Tabelle der Anwendungs-Registrys \[oauth_entity\] gespeichert. Das System erstellt einen Datensatz vom Typ OAuth-Provider in der Tabelle der Anwendungs-Registrys \[oauth_entity\]. Die Instanz generiert außerdem automatisch ein Standardprofil mit dem angegebenen Gewährungstyp, jedoch ohne Bereiche. ## Nächste Maßnahme Sie können [zusätzliche Profile erstellen](https://servicenow-prod.fluidtopics.net/773PvCmHjWxh~4PdlLQ_cQ "Ein OAuth-Profil enthält den Gewährungstyp, den der externe OAuth-Provider benötigt, um Zugriff auf die eingeschränkte Ressource zu erhalten."), jeweils mit Bereichen. * **[OAuth-Profile und -Bereiche](https://servicenow-prod.fluidtopics.net/8HeXpBEOA3CBKNKKHYVKrA)** Im OAuth-Provider-Szenario bestimmen Profile und Bereiche den Gewährungstyp, den Autorisierungstyp und die Zugriffsebene.