> 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

La Solución de Contraseña de Administrador Local (LAPS) resolverá el problema de usar credenciales administrativas idénticas en todos los equipos Windows para fines de soporte y emergencia. 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 te permite solicitar una "Support Account" (administrador local) para un dispositivo determinado en tu Tenant. Consulta [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 implementar el RealmJoin Windows Client.

Se asume que has configurado correctamente LAPS en tu entorno y que has implementado el RealmJoin Windows Client en tus dispositivos. Además, asegúrate de [autenticar ](/es/dev-reference/realmjoin-api/authentication.md)cada solicitud contra la API de RealmJoin usando un encabezado HTTP Authorization adecuado.

## Solicitar una cuenta de soporte

Indica a RealmJoin que cree una cuenta de soporte 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 se cree/esté utilizable.

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

### Ejemplo

Supongamos la siguiente situación:

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

Actualmente no existe ninguna cuenta de soporte en el dispositivo de destino.

![Cuentas locales - antes de solicitar una cuenta de soporte](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 la **solicitar**:

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 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 cuenta de soporte local. En este ejemplo, espera al menos 12 minutos. Si el cliente no se ha visto durante mucho tiempo, podrías 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 cuenta de soporte

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

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

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

![Cuentas locales - la cuenta de soporte 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)

**Solicitar**

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

**Respuesta**

Si las credenciales aún no están disponibles, el endpoint devolverá el estado HTTP: `404` (No encontrado) 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"
}
```

Puedes 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"
}
```

Puedes usar estas credenciales para brindar soporte a un usuario, por ejemplo, conectándote a través del AnyDesk Supporter Client.

Como puedes ver, de forma predeterminada una cuenta de soporte tiene una vida útil limitada y tendrá que recrearse si se necesita acceso después de la fecha de expiración. Esto es para asegurarse de que ninguna credencial de alto privilegio persista de una tarea operativa diaria a otra.


---

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