> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/user/security/create-temporary-access-pass.md). # Temporary Access Pass erstellen Einen Temporary Access Pass für einen Benutzer erstellen ### Beschreibung Erstellt eine neue Temporary Access Pass (TAP)-Authentifizierungsmethode für einen Benutzer in Microsoft Entra ID. Vorhandene TAPs für den Benutzer werden entfernt, bevor ein neuer erstellt wird. Sendet optional eine Benachrichtigungs-E-Mail an die primäre E-Mail-Adresse des Benutzers, um ihn über den neu erstellten TAP zu informieren. Die E-Mail-Sprache wird automatisch anhand des Nutzungsstandorts des Benutzers bestimmt. ### Benutzerbenachrichtigung aktivieren Dieses Runbook sendet dem Benutzer eine E-Mail mit dem Temporary Access Pass. Um dies zu ermöglichen, müssen Sie die Benutzerbenachrichtigung in der Runbook-Anpassung aktivieren. Die JSON-Konfiguration dafür lautet wie folgt: ```json "rjgit-user_security_create-temporary-access-pass": { "parameters": { "UserName": { "Hide": true }, "NotifyUser": { "Default": true, "Hide": true }, "EmailFrom": { "Hide": true }, "ServiceDeskDisplayName": { "Hide": true }, "ServiceDeskEmail": { "Hide": true }, "ServiceDeskPhone": { "Hide": true }, "ServiceDeskPortalUrl": { "Hide": true }, "ServiceDeskTicketUrl": { "Hide": true }, "CallerName": { "Hide": true } } } ``` Weitere Informationen dazu, wie Runbooks angepasst werden können, finden Sie im [Leitfaden zur Runbook-Anpassung](https://docs.realmjoin.com/automation/runbooks/runbook-customization). ### Einstellungen zum E-Mail-Versand Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn ein Empfänger (`EmailTo`) angegeben ist. Die Absenderadresse wird aus der `RJReport.EmailSender` Mandanteneinstellung übernommen. Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph API zu senden, müssen Sie in der Runbook-Anpassung eine vorhandene E-Mail-Adresse konfigurieren. Siehe die [RealmJoin Report Settings-Dokumentation](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details zu allen verfügbaren Einstellungen. #### E-Mail-Branding Die Bericht-E-Mail berücksichtigt optional die `RJReport.Branding.*` Mandanteneinstellungen: * **Kopf- und Fußzeilenbild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils * **Fußzeilenlink** – Ziel des Fußzeilenbilds * **Akzent- und Textfarbe** – 6-stellige Hex-Werte, z. B. `#0052cc` Wenn diese Einstellungen nicht konfiguriert sind, werden die standardmäßigen RealmJoin-Grafiken und -Farben verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die Bericht-E-Mail – stattdessen wird der entsprechende Standardwert verwendet. Einrichtungsanweisungen und Bildanforderungen: [E-Mail-Branding](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional). ### Speicherort Benutzer → Sicherheit → Temporary Access Pass erstellen **Vollständiger Runbook-Name** rjgit-user\_security\_create-temporary-access-pass ### Details | Eigenschaft | Wert | | -------------------- | ---------------------------------- | | Version | 1.4.0 | | Erforderliche Module | RealmJoin.RunbookHelper (>= 0.8.9) | | Planbar | nein | ### Berechtigungen #### Anwendungsberechtigungen * **Typ**: Microsoft Graph * UserAuthenticationMethod.ReadWrite.All * *Löscht vorhandene Temporary Access Pass und erstellt den neuen* * User.Read.All * *Liest die E-Mail und den Nutzungsstandort des Benutzers über /users/{UPN} für die Ausgabe und Benachrichtigung* * Mail.Send *(optional — Funktion: E-Mail-Benachrichtigung)* * *Sendet den neuen Temporary Access Pass an den Benutzer, wenn NotifyUser aktiviert ist* ### Parameter #### UserName UPN (Benutzerprinzipalname) des Zielbenutzers. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | wahr | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### LifetimeInMinutes Lebensdauer des Temporary Access Pass in Minuten. Gültige Werte liegen zwischen 60 und 480 Minuten (1-8 Stunden). | Eigenschaft | Wert | | ------------ | ------ | | Erforderlich | falsch | | Standardwert | 240 | | Typ | Int32 | #### OneTimeUseOnly Wenn auf true gesetzt, kann der Pass nur einmal verwendet werden. | Eigenschaft | Wert | | ------------ | -------- | | Erforderlich | falsch | | Standardwert | Wahr | | Typ | Boolesch | #### NotifyUser Wenn aktiviert, sendet eine Benachrichtigungs-E-Mail an die primäre E-Mail-Adresse des Benutzers über den neu erstellten TAP. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | Falsch | | Typ | Boolesch | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### EmailFrom Die Absender-E-Mail-Adresse. Diese muss in der Runbook-Anpassung konfiguriert werden. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingHeaderImageUrl Optionale öffentliche HTTPS-URL eines benutzerdefinierten Kopfzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Bericht-E-Mail. Stammt aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl. Wenn leer, wird die standardmäßige RealmJoin-Kopfzeilengrafik verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingFooterImageUrl Optionale öffentliche HTTPS-URL eines benutzerdefinierten Fußzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Bericht-E-Mail. Stammt aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl. Wenn leer, wird die standardmäßige RealmJoin-Fußzeilengrafik verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingFooterLink Optionale URL, auf die das Fußzeilenbild verweist. Stammt aus der Mandanteneinstellung RJReport.Branding.FooterLink. Wenn leer, wird der Standardlink () verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingAccentColor Optionale Überschreibung der Akzentfarbe (6-stelliger Hex-Wert, z. B. '#0052cc') für die Bericht-E-Mail-Vorlage. Stammt aus der Mandanteneinstellung RJReport.Branding.AccentColor. Wenn leer oder ungültig, wird die standardmäßige RealmJoin-Akzentfarbe verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingTextColor Optionale Überschreibung der Textfarbe (6-stelliger Hex-Wert) für die Bericht-E-Mail-Vorlage. Stammt aus der Mandanteneinstellung RJReport.Branding.TextColor. Wenn leer oder ungültig, wird die standardmäßige RealmJoin-Textfarbe verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### ServiceDeskDisplayName Anzeigename des Service Desks für Benutzerkontaktdaten (optional). | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### ServiceDeskEmail E-Mail-Adresse des Service Desks für Benutzerkontaktdaten (optional). | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### ServiceDeskPhone Telefonnummer des Service Desks für Benutzerkontaktdaten (optional). | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### ServiceDeskPortalUrl URL des Service-Desk-Portals für Benutzerkontaktdaten, als anklickbarer Link dargestellt (optional). | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### ServiceDeskTicketUrl Direkter Link zum Service-Desk-Ticket, das mit dieser Anfrage verknüpft ist, als anklickbarer Link dargestellt (optional). Standardmäßig leer, daher wird kein Ticketlink hinzugefügt. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | [Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/runbooks/runbook-references.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/user/security/create-temporary-access-pass.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.