# Mapeo de atributos SCIM

> Asigna atributos SCIM a los metadatos de usuario en Applivery para mantener la información de usuario consistente — personaliza el mapeo de atributos para una mejor Gestión de Usuarios.

Source: https://docs.applivery.com/es/device-management/integrations/sso/scim-attributes-mapping/  •  Last updated: 2026-03-27

**Answers:** ¿Cuál es la finalidad de attributesHistory en el SCIM de Applivery? · ¿Cómo asigno atributos SCIM a los metadatos de usuario en Applivery? · ¿Qué es el campo name en la configuración mappedAttributes? · ¿Cómo resuelve Applivery qué valor SCIM asignar a los metadatos? · ¿Dónde puedo encontrar los Ajustes de proveedores de inicio de sesión en Applivery? · ¿Cómo determino el namespace correcto para el mapeo de atributos SCIM en Applivery? · ¿Qué ocurre después de guardar los cambios del mapeo de atributos SCIM en Applivery? · ¿Es el mapeo de atributos SCIM una función premium de Applivery?

**Key topics:** Mapeo de atributos SCIM, Configuración de metadatos de usuario, Integración SCIM con Applivery, Resolución de atributos SCIM, Integración con proveedor de identidad, SCIM, Applivery, IdP, Okta

---

**TL;DR:** Applivery permite asignar atributos SCIM a los metadatos de usuario para una gestión mejorada, configurando mapeos personalizados y siguiendo reglas de resolución específicas.

:::warning
Esta es una función premium que puede no estar disponible en tu plan actual. Consulta la disponibilidad en nuestra [página de precios](https://www.applivery.com/pricing/).
:::

Al recibir información de usuario a través de SCIM, los datos a menudo se organizan en varios esquemas. Para mantener esta información consistente, utilizable y accesible, Applivery puede asignar atributos SCIM específicos al campo `metadata` del usuario.

## Entender el almacenamiento de atributos SCIM

Todos los campos SCIM mapeables se almacenan automáticamente en un objeto interno llamado `attributesHistory`. Este objeto rastrea cada atributo recibido de SCIM, esté o no actualmente asignado a metadatos.

### Historial de atributos SCIM

El objeto `attributesHistory` contiene todos los atributos SCIM con la siguiente estructura:

```typescript
type IProviderSCIMAttributesHistory = {
  namespace: string
  key: string
}
```

Este objeto se puebla automáticamente con todos los atributos proporcionados en las solicitudes SCIM. Su propósito es servir como registro completo de cualquier campo que pueda potencialmente ser asignado.

### Mapeo de atributos personalizado

Para asignar campos SCIM a los metadatos del usuario, puedes definir un mapeo personalizado a través de la propiedad `mappedAttributes` en el modelo de configuración SCIM.

```typescript
type IProviderSCIMCustomAttributes = {
  name: string
  attributes?: {
    namespace?: string
    key: string
  }[]
}
```

Cada entrada de mapeo admite los siguientes campos:

-   **Name**: La clave bajo la que se almacenará el valor asignado dentro de los metadatos del usuario.

-   **Attributes**: Una lista de atributos SCIM (especificando opcionalmente su namespace/esquema) que se usarán para generar este valor de metadatos.

:::tip
Para obtener orientación sobre cómo definir atributos personalizados dentro de tu proveedor de identidad (IdP), consulta el [siguiente artículo de nuestra documentación](https://docs.applivery.com/es/device-management/integrations/sso/scim-attribute-creation-and-assignment-in-okta/).
:::

### Reglas de resolución

Al resolver qué valor SCIM asignar a `metadata`, Applivery sigue estas reglas:

1.  Si se especifica un namespace, el sistema busca el atributo SCIM dentro de ese namespace/esquema exacto.

2.  Si no se define ningún namespace, el sistema asigna la primera clave de atributo coincidente encontrada en cualquier esquema.

3.  Cuando un payload SCIM incluye un valor para un atributo personalizado asignado, Applivery lo escribe automáticamente en los `metadata` del usuario:

    -   **Key**: El nombre definido en la entrada de `mappedAttributes`.

    -   **Value**: El valor del atributo SCIM resuelto basado en las reglas de mapeo.

### Ejemplo de mapeo basado en namespace

#### Payload SCIM

```json
{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:company:params:scim:schemas:extension:custom:2.0:User"
  ],
  "urn:ietf:params:scim:schemas:core:2.0:User": {
    "userName": "jane.smith"
  },
  "urn:company:params:scim:schemas:extension:custom:2.0:User": {
    "employeeId": "EMP-4567",
    "department": "Engineering"
  }
}
```

#### Configuración de mapeo personalizado

```javascript
const mappedAttributes = [
  {
    name: "department",
    attributes: [
      {
        namespace: "urn:company:params:scim:schemas:extension:custom:2.0:User",
        key: "department"
      }
    ]
  },
  {
    name: "employeeCode",
    attributes: [
      {
        namespace: "urn:company:params:scim:schemas:extension:custom:2.0:User",
        key: "employeeId"
      }
    ]
  }
]
```

#### Resultado en los metadatos del usuario

```json
{
  "metadata": {
    "department": "Engineering",
    "employeeCode": "EMP-4567"
  }
}
```

## Configura el mapeo de atributos en Applivery

**Ve a los Ajustes de proveedores de inicio de sesión**

Una vez en el [**panel de Applivery**](https://dashboard.applivery.io/), dirígete a los **Ajustes del Workspace** 1 desde el menú desplegable superior, luego abre ** Proveedores de acceso** 2 en el menú de la izquierda y haz clic en la opción **SAML** bajo la sección **Portal MDM** 3.

![login providers](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/0c5fb7b6-4277-4b92-830c-ebb4a3cdc744.png)

**Introduce el namespace**

Desplázate hasta el **Paso 3** e introduce el namespace apropiado. Puedes determinar el namespace correcto basándote en el tipo de atributo (Core, Enterprise o Custom) y su valor.

![attribute mapping](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/1295fb1c-b743-4791-8354-339c41df6e2c.png)

**Guarda los cambios**

Para guardar los cambios, simplemente haz clic en Guardar. Una vez que tu IdP realice su próxima sincronización programada, los atributos asignados en ambos lados empezarán a poblar los `metadata` de cada usuario en Applivery.

En resumen:

-   Los atributos SCIM se pueden asignar a los metadatos de usuario usando `mappedAttributes`.

-   El `namespace` ayuda a distinguir atributos cuando hay múltiples esquemas implicados.

-   Los atributos SCIM no asignados se almacenan en `attributesHistory` para referencia futura.

-   Este sistema de mapeo te da control total sobre cómo se almacenan y aprovechan los datos de usuario.
