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

# Administración de contraseñas de administrador local

RealmJoin administra cuentas individuales de administrador local (LAPS) mediante API, con contraseñas almacenadas cifradas en Azure Key Vault.

## Resumen

Local Administrator Password Solution (LAPS) resolverá el problema de usar credenciales administrativas idénticas en cada computadora Windows para fines de soporte y emergencias. Por sí solo, LAPS crea una contraseña generada aleatoriamente para una cuenta de administrador local.

Con RealmJoin es posible administrar cuentas administrativas seguras e individualizadas, ya sea para soporte local o soporte remoto a gran escala. RealmJoin guarda contraseñas cifradas en Azure Key Vault dentro del Tenant del cliente y almacena registros de auditoría de cada acceso a estas credenciales.

La API de RealmJoin le permite solicitar una "Support Account" (administrador local) para un dispositivo determinado en su Tenant. Vea [la referencia de la API de RealmJoin](https://customer-api.realmjoin.com/scalar/v1) para ver en detalle qué operaciones son compatibles actualmente. Usar LAPS con RealmJoin requiere la implementación del RealmJoin Windows Client.

Se asume que ha configurado correctamente LAPS en su entorno y ha implementado el RealmJoin Windows Client en sus dispositivos. Además, asegúrese de [autenticar ](https://docs.realmjoin.com/es/dev-reference/realmjoin-api/authentication.md)cada solicitud a la API de RealmJoin usando un encabezado HTTP Authorization adecuado.

## Solicitud de una Support Account

Indique a RealmJoin que cree una Support Account local en el dispositivo de destino usando el endpoint `/laps/request`. La solicitud se pone en cola usando Application insights y será procesada por RealmJoin Backend y RealmJoin Windows Client lo antes posible. Cuando la cuenta esté creada/utilizable.

El endpoint devolverá una estimación de cuánto tardará en crearse la cuenta. Cuando la cuenta esté lista, vea [aquí](#retrieve-support-account-credentials) cómo consultar las credenciales.

### Ejemplo

Supongamos la siguiente situación:

* Tiene sus credenciales de la API de RealmJoin y las ha codificado en `dC0xMjM0MTIzNDpteVMzY3JldCE=` (Base64)
* El Entra del dispositivo de destino `deviceId` esté `9999dab9-f946-40ee-9a17-2500c8d00878`. Tenga en cuenta que este no es el id de objeto de Entra (¡atributo diferente)!

Actualmente no existe ninguna Support Account en el dispositivo de destino.

![Cuentas locales - antes de solicitar una Support Account](https://3832142177-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)

Construyamos el **solicitud**:

Encabezados:

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

Solicitud / URI:

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

Este endpoint no espera un cuerpo de la solicitud.

**Respuesta**

Estado HTTP: `200` (OK)

Cuerpo (en notación JSON):

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

La respuesta contiene el tiempo aproximado hasta que el RealmJoin Windows Client cree la Support Account local. En este ejemplo, espere al menos 12 minutos. Si el cliente no se ha visto durante mucho tiempo, podría obtener `null` como estimación en lugar de un número.

El RealmJoin Windows Client consultará trabajos cada 30 min de forma predeterminada. La aproximación ofrecida por la API se basa en la última vez que el Windows Client se conectó.

## Obtener credenciales de la Support Account

El endpoint `/laps/retrieve` se usa para consultar si ya se ha creado una Support Account, así como para recopilar las credenciales reales de la Support Account.

Consultemos la misma `deviceId` de `9999dab9-f946-40ee-9a17-2500c8d00878` que en el ejemplo [anterior](#requesting-a-support-account).

En nuestro ejemplo, el RealmJoin Windows Client ha creado una Support Account (Nombre completo: "Local Support Admin Account") en el dispositivo de destino:

![Cuentas locales - la Support Account se ha creado correctamente](https://3832142177-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)

**Solicitud**

Encabezados:

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

Solicitud / URI:

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

Este endpoint no espera un cuerpo de la solicitud.

**Respuesta**

Si las credenciales aún no están disponibles, el endpoint devolverá el Estado HTTP: `404` (Not Found) y algunos detalles técnicos en el cuerpo:

Cuerpo (JSON)

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

Puede seguir consultando hasta que las credenciales estén listas.

Si las credenciales están listas, el endpoint devolverá el Estado HTTP: `200` (OK) y las credenciales:

Cuerpo (JSON)

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

Puede usar estas credenciales para ofrecer soporte a un usuario, por ejemplo, conectándose mediante el AnyDesk Supporter Client.

Como puede ver, de forma predeterminada una Support Account tiene una vida útil limitada y deberá recrearse si se necesita acceso después de la fecha de expiración. Esto es para asegurarse de que no persistan credenciales con altos privilegios de un día para otro en las tareas operativas.


---

# 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/es/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.
