> 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/dev-reference/local-admin-password-management.md).

# Verwaltung lokaler Administratorkennwörter

RealmJoin verwaltet individuelle lokale Administrator-Konten (LAPS) über eine API, wobei die Kennwörter verschlüsselt in Azure Key Vault gespeichert werden.

## Übersicht

Local Administrator Password Solution (LAPS) löst das Problem, identische administrative Anmeldeinformationen auf jedem Windows-Computer für Support- und Notfallzwecke zu verwenden. Für sich allein erstellt LAPS ein zufällig generiertes Passwort für ein lokales Admin-Konto.

Mit RealmJoin ist es möglich, sichere und individuelle administrative Konten zu verwalten, entweder für lokalen Support oder Remote-Support in großem Maßstab. RealmJoin speichert verschlüsselte Passwörter in Azure Key Vault innerhalb des Tenant des Kunden und speichert Prüfprotokolle jedes Zugriffs auf diese Anmeldeinformationen.

Die API von RealmJoin ermöglicht es Ihnen, für ein bestimmtes Gerät in Ihrem Tenant ein "Support Account" (lokaler Admin) anzufordern. Siehe [RealmJoin API-Referenz](https://customer-api.realmjoin.com/scalar/v1) um im Detail zu sehen, welche Operationen derzeit unterstützt werden. Die Verwendung von LAPS mit RealmJoin erfordert die Bereitstellung des RealmJoin Windows Client.

Es wird davon ausgegangen, dass Sie LAPS in Ihrer Umgebung korrekt eingerichtet und den RealmJoin Windows Client auf Ihren Geräten bereitgestellt haben. Stellen Sie außerdem sicher, [authentifizieren ](https://docs.realmjoin.com/de/dev-reference/realmjoin-api/authentication.md)jede Anfrage an die API von RealmJoin mit einem geeigneten HTTP Authorization-Header zu authentifizieren.

## Anfordern eines Support-Kontos

Teilen Sie RealmJoin mit, über den Endpunkt ein lokales Support-Konto auf dem Zielgerät zu erstellen `/laps/request`. Die Anfrage wird mithilfe von Application Insights in die Warteschlange gestellt und wird vom RealmJoin Backend und dem RealmJoin Windows Client so schnell wie möglich verarbeitet. Sobald das Konto erstellt/verwendbar ist.

Der Endpunkt gibt eine Schätzung zurück, wie lange die Kontoerstellung dauern wird. Wenn das Konto bereit ist, siehe [hier](#retrieve-support-account-credentials) wie die Anmeldeinformationen abgefragt werden können.

### Beispiel

Nehmen wir die folgende Situation an:

* Sie haben Ihre RealmJoin API-Anmeldeinformationen und sie kodiert zu `dC0xMjM0MTIzNDpteVMzY3JldCE=` (Base64)
* Die Entra-ID des Zielgeräts `deviceId` ist `9999dab9-f946-40ee-9a17-2500c8d00878`. Beachten Sie, dass dies nicht die Entra-Objekt-ID ist (anderes Attribut)!

Derzeit existiert auf dem Zielgerät kein Support-Konto.

![Lokale Konten - vor dem Anfordern eines Support-Kontos](https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FFlbUzySBT9dqV4nrm6kx%2FLaps-before.png?alt=media\&token=e5e95f49-1293-4696-ad1f-a245bb6b42e6)

Erstellen wir die **anfordern**:

Header:

```http
Authorization: Basic dC0xMjM0MTIzNDpteVMzY3JldCE=
Content-Type: application/json
```

Anfrage / URI:

```http
POST https://customer-api.realmjoin.com/laps/request?deviceID=9999dab9-f946-40ee-9a17-2500c8d00878
```

Dieser Endpunkt erwartet keinen Request-Body.

**Antwort**

HTTP-Status: `200` (OK)

Body (in JSON-Notation):

```json
{
    "estimatedWaitTime": "00:12:31.8215813"
}
```

Die Antwort enthält die ungefähre Zeit, bis der RealmJoin Windows Client das lokale Support-Konto erstellt. In diesem Beispiel sollten Sie mit mindestens 12 Minuten Wartezeit rechnen. Wenn sich der Client längere Zeit nicht gemeldet hat, erhalten Sie möglicherweise `null` als Schätzung statt einer Zahl.

Der RealmJoin Windows Client fragt standardmäßig alle 30 Minuten nach Jobs. Die von der API angebotene Schätzung basiert auf dem letzten Zeitpunkt, an dem sich der Windows Client gemeldet hat.

## Anmeldeinformationen des Support-Kontos abrufen

Der Endpunkt `/laps/retrieve` wird verwendet, um zu prüfen, ob bereits ein Support-Konto erstellt wurde, sowie um die tatsächlichen Anmeldeinformationen des Support-Kontos abzurufen.

Fragen wir dasselbe ab `deviceId` von `9999dab9-f946-40ee-9a17-2500c8d00878` wie im Beispiel [oben](#requesting-a-support-account).

In unserem Beispiel wurde auf dem Zielgerät durch den RealmJoin Windows Client ein Support-Konto (vollständiger Name: "Local Support Admin Account") erstellt:

![Lokale Konten - Support-Konto wurde erfolgreich erstellt](https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F8ePPJ2SxA29zcJsmGKX7%2FLaps-after.png?alt=media\&token=2d24e9ce-fa68-4499-a597-f0789f0a6115)

**Anfrage**

Header:

```http
Authorization: Basic dC0xMjM0MTIzNDpteVMzY3JldCE=
Content-Type: application/json
```

Anfrage / URI:

```http
POST https://customer-api.realmjoin.com/laps/retrieve?deviceID=9999dab9-f946-40ee-9a17-2500c8d00878
```

Dieser Endpunkt erwartet keinen Request-Body.

**Antwort**

Wenn die Anmeldeinformationen noch nicht verfügbar sind, gibt der Endpunkt den HTTP-Status zurück: `404` (Not Found) und einige technische Details im Body:

Body (JSON)

```json
{
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.4",
    "title": "Nicht gefunden",
    "status": 404,
    "traceId": "00-4c56c3cb0f9b394abf934b107b148613-1234b2497e261649-00"
}
```

Sie können weiter abfragen, bis die Anmeldeinformationen bereit sind.

Wenn die Anmeldeinformationen bereit sind, gibt der Endpunkt den HTTP-Status zurück: `200` (OK) und die Anmeldeinformationen:

Body (JSON)

```json
{
    "password": "Upji1234",
    "username": "ADM-5A2F2169",
    "accountExpirationDate": "2021-12-21T02:14:07+00:00"
}
```

Sie können diese Anmeldeinformationen verwenden, um einem Benutzer Support zu leisten, z. B. indem Sie sich über den AnyDesk Supporter Client verbinden.

Wie Sie sehen, hat ein Support-Konto standardmäßig eine begrenzte Lebensdauer und muss neu erstellt werden, wenn nach dem Ablaufdatum erneut Zugriff benötigt wird. Damit soll sichergestellt werden, dass keine hochprivilegierten Anmeldeinformationen aus alltäglichen Betriebsvorgängen fortbestehen.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/de/dev-reference/local-admin-password-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
