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


---

# OAuth-Profile und -Umfänge

# OAuth-Profile und -Umfänge {#ariaid-title1}

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

Im OAuth-Anbieterszenario geben Profile und Umfänge den Gewährungstyp, Autorisierungstyp und die Zugriffsebene an.
Im OAuth-Anbieterszenario bezieht sich das OAuth-Profil auf eine Kombination aus einem Gewährungstyp und mindestens einem Umfang. Der Bereich gibt den Zugriff an, den der Anwender auf die geschützte Ressource hat, z. B. Lesen Oder Schreiben . Sie können ein Profil für jeden Drittanbieter erstellen und den spezifischen Satz von Umfängen vom Anbieter abrufen. Siehe [Geben Sie ein OAuth-Profil an](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.")Und [Geben Sie einen OAuth-Bereich an](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.")Für weitere Informationen. Die Instanz verwendet auch OAuth-Profile, wenn ein REST-Aufruf die OAuth 2,0-Authentifizierung angibt. Die Instanz erstellt automatisch ein Standardprofil für jeden Datensatz des Drittanbieters, den Sie erstellen. Es kann nur ein Standardprofil geben.  
Geben Sie die folgenden Parameter an, die in der Tabelle „OAuth-Anfordererprofil" \[OAuth_Requestor_Profile\] gespeichert werden: {#c_OAuthProviderAndScope__table_u14_lcp_vs__entry__2}

| Parameter | Beschreibung |
|-|-|
| `oauth_Anforderer` | Die sys_ID des Objekts, bei der es sich um einen Anwenderdatensatz oder einen E-Mail-Account handeln kann. |
| `oauth_Requestor_context` | Deskriptor, der Kontext für die OAuth-Anforderer bereitstellt. Verwenden Sie als bewährte Praxis den Namen der Tabelle, in der `oauth_Anforderer `Objekt ist gespeichert. |
| `oauth_Provider_Profile` | Die sys_ID des OAuth-Profildatensatzes, die der Standard ist (siehe [Geben Sie ein OAuth-Profil an](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.")). |
[Tabelle : 1. OAuth-Parameter für Standardprofilunterstützung]

{#c_OAuthProviderAndScope__table_u14_lcp_vs}

Wenn der Anwender versucht, sich zu authentifizieren, greift der Anbieter auf die Tabelle „OAuth-Anfordererprofil" zu, um nach dem Anwender zu suchen. Wenn der Anwender gefunden wird, ist die Authentifizierung erfolgreich. Wenn nicht, greift der Anbieter auf das Standardprofil zu, um den Gewährungstyp und die Vorgehensweise für die Authentifizierung zu bestimmen.
* **[Geben Sie ein OAuth-Profil an](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.
* **[Geben Sie einen OAuth-Bereich an](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.

