---
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


---

# OAuth-Profile und -Bereiche

# OAuth-Profile und -Bereiche {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Im OAuth-Provider-Szenario bestimmen Profile und Bereiche den Gewährungstyp, den Autorisierungstyp und die Zugriffsebene.
Im OAuth-Provider-Szenario bezieht sich das OAuth-Profil auf eine Kombination aus einem Gewährungstyp und mindestens einem Bereich. Der Umfang gibt den Zugriff an, den der Benutzer auf die geschützte Ressource hat, z. B. Lese- oder Schreibzugriff. Sie können für jeden externen Provider ein Profil erstellen und die spezifische Kombination von Bereichen vom Provider erhalten. Siehe [OAuth-Profile angeben](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.") und [OAuth-Bereiche angeben](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."), um weitere Informationen zu erhalten. Die Instanz verwendet auch dann OAuth-Profile, wenn die OAuth 2.0-Authentifizierung bei einem REST-Aufruf angegeben wird. Die Instanz erstellt automatisch ein Standardprofil für jeden von Ihnen erstellten Datensatz eines externen Providers. Es kann nur ein Standardprofil geben.  
Geben Sie die folgenden Parameter an, die in der Tabelle \[OAuth_requestor_profile\] des OAuth-Anfordererprofils gespeichert sind: {#c_OAuthProviderAndScope__table_u14_lcp_vs__entry__2}

| Parameter | Beschreibung |
|-|-|
| `oauth_requestor` | Die sys_id des Objekts. Dies kann ein Benutzerdatensatz oder ein E-Mail-Account sein. |
| `oauth_requestor_context` | Deskriptor, der den Kontext für den OAuth-Anforderer bereitstellt. Verwenden Sie als bewährte Methode den Namen der Tabelle, in der das Objekt `oauth_requestor` gespeichert wird. |
| `oauth_provider_profile` | Die sys_id des OAuth-Profildatensatzes, der der Standard ist (siehe [OAuth-Profil](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.")angeben ). |
[Tabelle : 1. OAuth-Parameter für die Unterstützung von Standardprofilen]

{#c_OAuthProviderAndScope__table_u14_lcp_vs}

Wenn der Benutzer versucht, sich zu authentifizieren, greift der Provider auf die OAuth-Anforderungsprofil-Tabelle zu, um nach dem Benutzer zu suchen. Wenn der Benutzer gefunden wird, ist die Authentifizierung erfolgreich. Ist dies nicht der Fall, greift der Provider auf das Standardprofil zu, um den Gewährungstyp und die Vorgehensweise bei der Authentifizierung zu bestimmen.
* **[OAuth-Profile angeben](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.
* **[OAuth-Bereiche angeben](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.