---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/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


---

# AuthCredential: Bereichsbezogen

# AuthCredential: Bereichsbezogen {#ariaid-title1}

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

Die API AuthCredential() stellt Methoden bereit, mit denen Sie Anmeldeinformationen für eine REST-Anforderung erstellen können.  
Generieren Sie ausgehende Signieranforderungen mit diesen APIs in der folgenden Reihenfolge:

1. HttpRequestData: API-Anforderung erstellen.
2. AuthCredential: Erstellen Sie ein Anmeldeinformationsobjekt, oder aktualisieren Sie ein vorhandenes Objekt. Verwenden Sie die Anmeldeinformationen, um die Anforderung über die RequestAuthAPI -Klasse zu signieren.
3. RequestAuthAPI: Signieren Sie die Anforderung und geben Sie ein HttpRequestAuthedData-Objekt zurück.
4. HttpRequestAuthedData: Ruft Informationen zur signierten Anforderung ab.
5. GlideHTTPRequest: Signierte Anforderung senden.
{#AuthCredentialAPI__ol_gvv_22t_tjb}

Bevor Sie diese APIs verwenden, müssen Sie [einen Authentifizierungsalgorithmus konfigurieren](https://www.servicenow.com/docs/access?context=configure-authentication-algorithm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US), um die Anforderung zu signieren und den Anmeldeinformationen zuzuordnen, die zur Authentifizierung der Anforderung verwendet werden.

Sie können ein leeres AuthCredential-Objekt erstellen, ein vorhandenes AuthCredential-Objekt instanziieren oder die Klasse „ StandardCredentialsProvider " verwenden, um ein AuthCredential-Objekt mit einem Anmeldeinformationsdatensatz aus der Tabelle „Anmeldeinformationen" \[discovery_credentials\] zu instanziieren. Wenn Sie ein leeres AuthCredential-Objekt erstellen, verwenden Sie die Methode setAttribute(), um dem Objekt Eigenschaften hinzuzufügen. {#AuthCredentialAPI__p_mpf_pjx_zjb}  
Das folgende Beispiel zeigt, wie AuthCredential mit StandardCredentialsProviderinstanziiert wird:

    // Return an AuthCredential object using a Credential sys_id
    var credential = new sn_cc.StandardCredentialsProvider().getAuthCredentialByID("5b61c16f73533300f662cff8faf6a74b");

Verwenden Sie die AuthCredential- API in bereichsbezogenen Skripts mit dem Namespace-Bezeichner `sn_auth`.

## AuthCredential: AuthCredential(Object authCredential) {#ariaid-title2}

Instanziiert ein neues AuthCredential-Objekt oder ändert ein vorhandenes Objekt.
Sie können ein leeres AuthCredential-Objekt erstellen, ein vorhandenes AuthCredential-Objekt instanziieren oder die Klasse „ StandardCredentialsProvider " verwenden, um ein AuthCredential-Objekt mit einem Anmeldeinformationsdatensatz aus der Tabelle „Anmeldeinformationen" \[discovery_credentials\] zu instanziieren. Wenn Sie ein leeres AuthCredential-Objekt erstellen, verwenden Sie die Methode setAttribute(), um dem Objekt Eigenschaften hinzuzufügen.
{#AuthCredential-AuthCredential_O__table_sjv_2sx_5jb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| authCredential | Objekt | Optional. Fügen Sie diesen Parameter ein, um ein vorhandenes AuthCredential-Objekt zu aktualisieren. |
[Tabelle : 1. Parameter]

{#AuthCredential-AuthCredential_O__table_sjv_2sx_5jb}

## AuthCredential -- getAttribute(Zeichenfolgeschlüssel) {#ariaid-title3}

Gibt den Wert eines AuthCredential-Attributs zurück.
{#AuthCredential-getAttribute_S__table_ss5_hsx_5jb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Schlüssel des Attributs, für das der Wert zurückgegeben werden soll. Wenn Sie ein leeres AuthCredential- Objekt erstellt haben, müssen Sie die Methode setAttribute() verwenden, um dem Objekt Eigenschaften hinzuzufügen. Wenn Sie einen Anmeldeinformationsdatensatz verwendet haben, um das AuthCredential- Objekt zu instanziieren, übergeben Sie einen Feldnamen aus der Tabelle „Anmeldeinformationen" \[discovery_credentials\], um auf den Wert zuzugreifen. |
[Tabelle : 2. Parameter]

{#AuthCredential-getAttribute_S__table_ss5_hsx_5jb} {#AuthCredential-getAttribute_S__table_ts5_hsx_5jb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 3. Ergebnisse]

{#AuthCredential-getAttribute_S__table_ts5_hsx_5jb}  

    // Define the HttpRequestData object
    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod("PUT");
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl', 'public-read' );
     
    // Get AuthCredential object and set an attribute
    var credential = new sn_auth.AuthCredential();
    credential.setAttribute("user_name", "admin");
     
    // Sign the request and return an AuthCredential attribute value
    var signingAPI = new sn_auth.RequestAuthAPI(httpRequestData, credential);
    var signingCredential = signingAPI.getAuthCredential();
    name = signingCredential.getAttribute("name");

## AuthCredential -- setAttribute(Zeichenfolgenschlüssel, Zeichenfolgenwert) {#ariaid-title4}

Legt ein Attribut für ein AuthCredential-Objekt fest.
{#AuthCredential-setAttribute_S_S__table_off_jsx_5jb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Name des festzulegenden Attributs Wenn Sie ein leeres AuthCredential- Objekt erstellt haben, müssen Sie diese Methode verwenden, um dem Objekt Eigenschaften hinzuzufügen. Wenn Sie einen Anmeldeinformationsdatensatz verwendet haben, um das AuthCredential- Objekt zu instanziieren, übergeben Sie einen Feldnamen aus der Tabelle „Anmeldeinformationen" \[discovery_credentials\], um den Wert festzulegen. |
| Wert | Zeichenfolge | Wert des Attributs. |
[Tabelle : 4. Parameter]

{#AuthCredential-setAttribute_S_S__table_off_jsx_5jb} {#AuthCredential-setAttribute_S_S__table_pff_jsx_5jb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 5. Ergebnisse]

{#AuthCredential-setAttribute_S_S__table_pff_jsx_5jb}  

    // Define the HttpRequestData object
    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod("PUT");
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl' , 'public-read' );
     
    // Get AuthCredential object and set an attribute
    var credential = new sn_auth.AuthCredential();
    credential.setAttribute("user_name", "admin");