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


---

# Konfigurieren Sie eine geskriptete REST-API-Ressource, um eine ACL zu erfordern

# Konfigurieren Sie eine geskriptete REST-API-Ressource, um eine ACL zu erfordern {#ariaid-title1}

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

Standardmäßig übernehmen API-Ressourcen/Endpunkte Sicherheitseinstellungen von der übergeordneten API. Definieren Sie anwenderdefinierte ACLs für eine bestimmte Ressource/einen bestimmten Endpunkt, um die geerbten Einstellungen zu überschreiben.

## Vorbereitungen

Erforderliche Rolle: Web_Service_admin oder admin

## Warum und wann dieser Vorgang ausgeführt wird

ACLs werden nur für einen authentifizierten Anwender überprüft.

## Prozedur

1. Navigieren zu AlleSystem-WebservicesScripted REST APIsan.
2. Wählen Sie eine geskriptete REST-API aus.
3. In Ressourcen Zugehörige Liste, wählen Sie eine Ressource aus.
4. In Sicherheit Wählen Sie die Registerkarte aus Erfordert Authentifizierung Kontrollkästchen.  
   Sie müssen dieses Kontrollkästchen aktivieren, um eine ACL für die Ressource zu erfordern. Wenn Sie dieses Kontrollkästchen deaktivieren, wird die Ressource öffentlich und erfordert keine Anmeldeinformationen. Deaktivieren Sie dieses Kontrollkästchen nur, wenn Sie nicht authentifizierte Anforderungen den Zugriff auf die Ressource zulassen möchten, auch wenn der übergeordnete REST-Service eine ACL erfordert.
5. Wählen Sie aus Erfordert ACL-Autorisierung Kontrollkästchen.
6. In ACL Feld eine oder mehrere ACLs auswählen, die die Sicherheitsanforderungen für den Endpunkt erfüllen.  
   Wählen Sie nur die ACLs aus, die über einen verfügen Typ Von REST_Endpoint . Nur Anwender, deren Rollen in der ausgewählten ACL vom Typ „REST_Endpoint" definiert sind, erhalten Zugriff auf diese Ressource.

   Wenn Sie eine ACL für eine Ressource auswählen, werden alle für den übergeordneten Webservice ausgewählten ACLs überschrieben. Lassen Sie dieses Feld leer, um die für den übergeordneten Webservice ausgewählten ACLs zu verwenden.
{#t_WbSvcOpRqACL__steps_pmq_njw_5r}
**Zugehörige Tasks**   

* [Konfigurieren Sie eine geskriptete REST-API, um eine ACL zu erfordern](https://servicenow-prod.fluidtopics.net/zQtfX_l3OFHSIYU96o18zQ "Anforderungen an geskriptete REST-APIs berücksichtigen Plattform-ACLs, und der anfordernde Anwender muss alle Tabellen-ACL-Anforderungen erfüllen, um auf Instanzdaten zuzugreifen. Darüber hinaus können Sie die geskriptete REST-API so konfigurieren, dass eine bestimmte ACL erforderlich ist.")

