---
sourceDocument: Yokohama Now Plattformverwaltung
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/platform-administration

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama Now Plattformverwaltung

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Zuordnung externer Anwender und Gruppen zu Now PlatformAnwender

# Zuordnung externer Anwender und Gruppen zu Now PlatformAnwender {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 4. Februar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer

KI-SucheMit Zuordnungen externer Anwender können Sie extern definierte Anwender- und Gruppenaliasse für konfigurieren Now PlatformAnwender. KI-SucheVerwendet diese aliasierten Sicherheitsprinzipale, um Inhaltssicherheitsfilter anzuwenden, die den Anwenderzugriff auf Suchergebnisse steuern, die aus externen Dokumenten indiziert wurden.

Sie können zugeordnete externe Anwender- und Gruppennamen verwenden, wenn Sie Zugriffsberechtigungen für externe Dokumente definieren, die Sie für die Indizierung über erfassen [API zur Erfassung externer Inhalte](https://www.servicenow.com/docs/access?context=external-content-ingestion-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US).

## Anwenderzuordnung für Sicherheit externer Inhalte -- Übersicht {#user-mappings-ais__section_jss_1cl_vpb}

Um Anwenderzuordnungen für die Sicherheit externer Inhalte zu konfigurieren, müssen Sie die folgenden Schritte ausführen:

1. Erstellen Sie eine oder mehrere Anwenderzuordnungstabellen. Anweisungen zu diesem Verfahren finden Sie unter [Erstellen Sie eine Anwenderzuordnungstabelle](https://servicenow-prod.fluidtopics.net/bq1W0fh~r5PJ_U0mOFhuSA#create-user-mapping-tables-ais "Definieren Sie eine Tabelle, für die extern definierte Anwender- und Gruppenaliasse gespeichert werden sollen Now PlatformAnwender.").
2. Verknüpfen Sie eine oder mehrere Ihrer Anwenderzuordnungstabellen mit jeder Ihrer indizierten Quellen für externe Inhalte. Details zu dieser Aufgabe finden Sie unter [Verknüpfen Sie Anwenderzuordnungstabellen mit indizierten Quellen für externe Inhalte](https://servicenow-prod.fluidtopics.net/bq1W0fh~r5PJ_U0mOFhuSA#link-usrmap-tables-idxsrcs-ais "Geben Sie die gewünschten Anwenderzuordnungstabellen an KI-SucheZur Verwendung für externe Dokumente, die über eine indizierte Quelle erfasst werden.").  
   Hinweis:  
   Wenn keine Zuordnung für die aktuelle gefunden wird Now PlatformAnwender, KI-SucheErmöglicht dem Anwender nur, Suchergebnisse für externe Dokumente anzuzeigen, die über verfügen everyoneBerechtigung auf „wahr" festgelegt. Dies kann vorkommen, wenn keine Anwenderzuordnungstabellen mit der indizierten Quelle eines Suchergebnisses verknüpft sind oder wenn keine Zuordnung für die aktuelle vorhanden ist Now PlatformAnwender ist in den verknüpften Anwenderzuordnungstabellen der indizierten Quelle vorhanden.
3. Importieren Sie Anwenderzuordnungen mit in Ihre Anwenderzuordnungstabellen [KI-Suche API für externe Anwenderzuordnung](https://www.servicenow.com/docs/access?context=ext-user-mapping-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)an.

{#user-mappings-ais__ol_nmz_dcl_vpb}Anwender mit ais_high_security_admin Die Rolle kann Verlaufsdatensätze für Importvorgänge überprüfen, um sicherzustellen, dass Anwenderzuordnungen korrekt importiert wurden. Anweisungen zu diesem Verfahren finden Sie unter [Verlaufsdatensätze für Importvorgänge der Anwenderzuordnung anzeigen](https://servicenow-prod.fluidtopics.net/bq1W0fh~r5PJ_U0mOFhuSA#view-usr-map-import-history-ais "Überprüfen Sie die Ergebnisse für Ihre Importvorgänge der Anwenderzuordnung, einschließlich Daten, Protokollnachrichten und Fehlern. Verwenden Sie dieses Verfahren, um sicherzustellen, dass Ihre Anwenderzuordnungen korrekt importiert wurden.").

## Externe Anwenderzuordnung -- Sicherheitsprinzipaltypen {#ariaid-title2}

KI-Suche Anwenderzuordnungsaliasse können extern definierte Gruppen- und Anwendersicherheitsprinzipien enthalten.
{#ext-usr-map-principal-types-ais__table_wqh_q5p_5pb__entry__2}

| Zugeordneter Sicherheitsprinzipaltyp | Beschreibung |
|-|-|
| Extern definierte Gruppe | Die Now Platform®Der in der Anwenderzuordnung angegebene Anwender erbt Zugriffsberechtigungen auf Gruppenebene für alle externen Gruppen mit Alias. Beispiel: Wenn Sie eine externe Gruppe definieren report-usersAls Alias für Now PlatformAnwender beth.anglin@example.com, KI-SucheErlaubt beth.anglin@example.comDient zum Anzeigen indizierter Suchergebnisse für externe Dokumente, die Lesezugriffsberechtigungen für enthalten report-users. |
| Extern definierter Anwender | Die Now PlatformDer in der Anwenderzuordnung angegebene Anwender erbt Zugriffsberechtigungen auf Anwenderebene für alle externen Anwender mit Alias. Beispiel: Wenn Sie einen externen Anwender definieren ad\\abel-tuterAls Alias für Now PlatformAnwender abel.tuter@example.com, KI-SucheErlaubt abel.tuter@example.comDient zum Anzeigen indizierter Suchergebnisse für externe Dokumente, die Lesezugriffsberechtigungen für enthalten ad\\abel-tuter. |
[ ]

{#ext-usr-map-principal-types-ais__table_wqh_q5p_5pb}

## Erstellen Sie eine Anwenderzuordnungstabelle {#ariaid-title3}

Definieren Sie eine Tabelle, für die extern definierte Anwender- und Gruppenaliasse gespeichert werden sollen Now Platform®Anwender.

### Vorbereitungen

Die Externer Inhalt für KI-Suche Plugin ( Com.Glide.ais.external_content ) Muss in Ihrer Instanz aktiviert sein.{#create-user-mapping-tables-ais__ais-external-content-plugin-id-ph}

Erforderliche Rolle: ais_admin

### Warum und wann dieser Vorgang ausgeführt wird

Anwenderzuordnungstabellen speichern Anwenderzuordnungen zur Verwendung mit externen Dokumenten, die Zugriffsberechtigungen haben. Jede Zuordnung gibt extern definierte Anwender- und Gruppenaliasse für eine Person an Now PlatformAnwender. KI-SucheVerwendet die Zuordnungen, die mit der indizierten Quelle eines externen Dokuments verknüpft sind, um zu bestimmen, ob ein Now PlatformAnwender kann den indizierten Datensatz für das Dokument anzeigen.

Alle Anwenderzuordnungstabellen erweitern KI-SucheAnwenderzuordnungsbasistabelle für externe Suche \[ais_external_search_user_mapping\].

### Prozedur

1. Navigieren zu AlleKI-SucheExterner InhaltAnwenderzuordnung erstellenan.
2. Geben Sie einen Namen für Ihre Anwenderzuordnungstabelle ein.
3. Wählen Sie Absenden.  
   Das Wörterbuchformular für Ihre neue Anwenderzuordnungstabelle wird angezeigt.
{#create-user-mapping-tables-ais__steps_hgn_qnp_5pb}

### Nächste Maßnahme

Importieren Sie Anwenderzuordnungen in Ihre neue Anwenderzuordnungstabelle. Eine Übersicht über diesen Prozess finden Sie unter [Anwenderzuordnungen werden importiert](https://servicenow-prod.fluidtopics.net/bq1W0fh~r5PJ_U0mOFhuSA#importing-user-mappings-ais "Sie können verwenden KI-SucheAPI für externe Anwenderzuordnung, zwischen der Zuordnungen importiert werden sollen Now PlatformAnwender und extern definierte Anwender und Gruppen."). Details zum relevanten API-Endpunkt finden Sie unter [KI-Suche API für externe Anwenderzuordnung](https://www.servicenow.com/docs/access?context=ext-user-mapping-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)an.

## Verknüpfen Sie Anwenderzuordnungstabellen mit indizierten Quellen für externe Inhalte {#ariaid-title4}

Geben Sie die gewünschten Anwenderzuordnungstabellen an KI-SucheZur Verwendung für externe Dokumente, die über eine indizierte Quelle erfasst werden.

### Vorbereitungen

Die Externer Inhalt für KI-Suche Plugin ( Com.Glide.ais.external_content ) Muss in Ihrer Instanz aktiviert sein.{#link-usrmap-tables-idxsrcs-ais__ais-external-content-plugin-id-ph}

Die Quelltabelle für die indizierte Quelle muss eine Schematabelle für externe Inhalte sein.

Erforderliche Rolle: ais_admin

### Warum und wann dieser Vorgang ausgeführt wird

Anwenderzuordnungen, die mit einer indizierten Quelle verknüpft sind, definieren externe Anwender- und Gruppenaliasse für Now Platform®Anwender. KI-SucheVerwendet diese Zuordnungen, um die effektiven Zugriffsberechtigungen eines Anwenders zu bestimmen, wenn seine Suche mit einem Datensatz aus der indizierten Quelle übereinstimmt.  
Eine Anwenderzuordnung kann mit einer beliebigen Anzahl indizierter Quellen verknüpft werden, und Sie können mehrere Anwenderzuordnungen mit einer einzelnen indizierten Quelle verknüpfen.  
Hinweis:  
Wenn keine Zuordnung für die aktuelle gefunden wird Now PlatformAnwender, KI-SucheErmöglicht dem Anwender nur, Suchergebnisse für externe Dokumente anzuzeigen, die über verfügen everyoneBerechtigung auf „wahr" festgelegt. Dies kann vorkommen, wenn keine Anwenderzuordnungstabellen mit der indizierten Quelle eines Suchergebnisses verknüpft sind oder wenn keine Zuordnung für die aktuelle vorhanden ist Now PlatformAnwender ist in den verknüpften Anwenderzuordnungstabellen der indizierten Quelle vorhanden.

### Prozedur

1. Navigieren zu AlleKI-SucheKI-Suche IndexIndizierte Quellenan.
2. Öffnen Sie den indizierten Quelldatensatz, mit dem Sie Anwenderzuordnungen verknüpfen möchten.
3. In KI-SucheExterne Suche -- Anwenderzuordnungstabelle -- Datenquellenbeziehungen -- führen Sie die folgenden Schritte für jede Anwenderzuordnung aus, die Sie mit der indizierten Quelle verknüpfen möchten:
   1. Wählen Sie Neu.
   2. Auf KI-SucheExterne Suche -- Anwenderzuordnungstabelle -- Datenquellenbeziehungsformular, füllen Sie die Felder aus.
   3. Wählen Sie Absenden.  
      Der Name der Anwenderzuordnungstabelle wird in der zugehörigen Liste angezeigt.
{#link-usrmap-tables-idxsrcs-ais__steps_wmn_l4p_5pb}

## Anwenderzuordnungen werden importiert {#ariaid-title5}

Sie können verwenden KI-SucheAPI für externe Anwenderzuordnung, zwischen der Zuordnungen importiert werden sollen Now Platform®Anwender und extern definierte Anwender und Gruppen.
Zum Definieren einer Anwenderzuordnung für den Import benötigen Sie die folgenden Informationen:

* Die E-Mail-Adresse, die eindeutig identifiziert Now PlatformAnwender in der Anwendertabelle \[sys_user\].
* Die Liste der extern definierten Gruppen, die Sie als Alias für verwenden möchten Now PlatformAnwender. Diese Liste kann leer sein.
* Die Liste der extern definierten Anwender, die Sie als Alias für verwenden möchten Now PlatformAnwender. Diese Liste kann leer sein.
{#importing-user-mappings-ais__ul_plj_4xp_5pb}

Weitere Informationen zum Importieren von Anwenderzuordnungen finden Sie unter [KI-Suche API für externe Anwenderzuordnung](https://www.servicenow.com/docs/access?context=ext-user-mapping-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)an.

## Verlaufsdatensätze für Importvorgänge der Anwenderzuordnung anzeigen {#ariaid-title6}

Überprüfen Sie die Ergebnisse für Ihre Importvorgänge der Anwenderzuordnung, einschließlich Daten, Protokollnachrichten und Fehlern. Verwenden Sie dieses Verfahren, um sicherzustellen, dass Ihre Anwenderzuordnungen korrekt importiert wurden.

### Vorbereitungen

Erforderliche Rolle: ais_admin , ais_high_security_admin , Und Import_Transformer.

### Warum und wann dieser Vorgang ausgeführt wird

KI-Suche Erstellt einen Importsatz für jeden Batch von Anwenderzuordnungen, die Sie über importieren [KI-Suche API für externe Anwenderzuordnung](https://www.servicenow.com/docs/access?context=ext-user-mapping-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)an. Die Transformationsverläufe für diese Importsätze bieten Einblicke in die Ergebnisse Ihrer Importvorgänge für Anwenderzuordnungen.

### Prozedur

1. Erhöhen Sie auf ais_high_security_admin Rolle, indem Sie die folgenden Schritte ausführen:
   1. Führen Sie die entsprechende Aktion für Ihre Version der UI aus:  
      {#view-usr-map-import-history-ais__table_els_wyl_vpb__entry__2}

      | UI-Version | Aktion |
      |-|-|
      | Next Experience UI | Wählen Sie im Bannerrahmen das Symbol für Ihren Account aus, um das Anwendermenü zu öffnen, und wählen Sie dann aus Erhöhen Sie die Rolle . |
      | Core-UI | Wählen Sie im Banner-Frame Ihren Namen aus, um das Anwendermenü zu öffnen, und wählen Sie dann aus Erhöhen Sie Rollen . |
      [ ]

      {#view-usr-map-import-history-ais__table_els_wyl_vpb}  
      Ein Dialogfeld wird angezeigt, in dem eine Prüfliste Ihrer verfügbaren privilegierten Rollen angezeigt wird.
   2. Wählen Sie im Dialogfeld aus ais_high_security_admin Option, und wählen Sie dann aus Aktualisieren (In Next ExperienceUI) oder OK .  
      Die Seite wird neu geladen, und neben Ihrem Anwendernamen wird im Anwendermenü ein Indikator für erweiterte Rollen angezeigt. In Next ExperienceUI, dieser Indikator zeigt die Namen der aktiven privilegierten Rollen an. In Core-UI, Der Indikator zeigt das Symbol „erhöhte Rolle" an ( ![Symbol für erhöhte Rolle.]()).  
      Hinweis:  
      Wenn die Seite neu geladen wird, gehen alle nicht gespeicherten Bearbeitungen verloren.
   {#view-usr-map-import-history-ais__substeps_ddc_3xl_vpb}
2. Navigieren zu AlleKI-SucheExterner InhaltImportverlauf von Anwenderzuordnungenan.
3. Führen Sie für jeden Importverlaufsdatensatz der Anwenderzuordnung, den Sie überprüfen möchten, die folgenden Schritte aus:
   1. Öffnen Sie den Importverlaufsdatensatz der Anwenderzuordnung.
   2. Auf KI-SucheAnwenderzuordnung für externen Inhalt -- Verlaufsdatensatz -- Formular auswählen Transformationsverlauf Anzeigen Zugehöriger Link.  
      Die Tabelle „Transformationsverlauf \[sys_import_set_run\]" wird geöffnet, wobei ein Filter für den Importsatz aus dem ausgewählten Importverlaufsdatensatz der Anwenderzuordnung angewendet wird.
   3. Öffnen Sie den Transformationsverlaufsdatensatz.
   4. Überprüfen Sie die Importsatzergebnisse im Formular, Fehler in der zugehörigen Liste „Importsatzzeilenfehler" und Protokollnachrichten in der zugehörigen Liste „Importsatzzeilenfehler".
   {#view-usr-map-import-history-ais__substeps_srt_2jm_vpb}