> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Socios

> Da a cada uno de tus propios clientes sus propias aplicaciones y elige qué puede hacer, dónde, desde qué direcciones y por cuánto tiempo.

Un socio es uno de tus propios clientes que llama a tu plataforma Lerian desde sus propios sistemas. Access Manager da a cada socio sus propias aplicaciones. Tú decides qué puede hacer el socio y en qué parte de los datos de un producto. También decides sus direcciones de red y su ventana de validez.

## Los bloques de construcción

***

Un socio es un registro de tu tenant. Las filas que lo siguen describen lo que defines para un socio.

| Concepto | Qué es |
| - | - |
| **Socio** | Un registro en tu tenant que representa a uno de tus propios clientes. Un socio no es un tenant. |
| **Aplicación del socio** | Una aplicación que pertenece a un socio. Un socio puede tener varias aplicaciones. |
| **Permisos** | Qué puede hacer el socio: un producto, sus recursos y las acciones sobre ellos. |
| **Ámbito** | Dónde puede hacerlo el socio: una restricción por dimensión del catálogo de ámbito del producto, con los valores que eliges. |
| **Catálogo de ámbito** | La lista de dimensiones que un producto publica para los socios, como un identificador de participante. |
| **Techo** | Lo máximo que puedes dar a un socio en un producto: los permisos del rol de editor de ese producto en tu tenant, y los permisos que el producto reserva para socios. |
| **Lista de IP permitidas del socio** | Una lista de direcciones de red que pertenece a un socio. |
| **Ventana de validez y estado** | El inicio y el fin del acceso del socio (`validFrom` y `validUntil`), y su estado: `active` o `suspended`. |

## Productos que aceptan socios

***

Puedes dar permisos a un socio solo en un producto que acepta socios. Un producto acepta socios cuando publica un catálogo de ámbito con la opción de socios activada.

Para ver qué productos aceptan socios en tu despliegue, lee los catálogos de ámbito con [Listar catálogos de ámbito](https://docs.lerian.studio/es/reference/platform/access-manager/list-scope-catalogs.md). Un producto acepta socios cuando su entrada tiene `partners: true`. Un producto sin entrada no publicó un catálogo de ámbito.

En la Console, el paso **Products** de la página de nuevo socio muestra como no disponibles los productos que no aceptan socios.

Cada producto tiene su propia página con sus restricciones, los campos donde el socio nombra sus elementos y los rechazos que recibe:

* [Socios en Midaz](https://docs.lerian.studio/es/platform/access-manager/features/partners/midaz.md)
* [Socios en Pix JD](https://docs.lerian.studio/es/platform/access-manager/features/partners/pix-jd.md)
* [Socios en Reporter](https://docs.lerian.studio/es/platform/access-manager/features/partners/reporter.md)
* [Socios en Flowker](https://docs.lerian.studio/es/platform/access-manager/features/partners/flowker.md)

## Lo que necesitas saber

***

* Cada producto define sus propias dimensiones en su catálogo de ámbito. El catálogo indica si una dimensión es obligatoria y si acepta más de un valor.
* **Un socio con permisos en un producto que declara dimensiones necesita un ámbito en él.** Dale al menos una entrada de ámbito para ese producto. Sin ella, Access Manager rechaza crear o cambiar el socio, con `400` y `IDE-1060`. Un socio guardado antes de esta regla, sin entrada de ámbito, se rechaza con `403` en cada solicitud a ese producto hasta que agregues una.
* La excepción es una entrada de permisos que tiene solo permisos que el producto reserva para socios. Una entrada así no necesita ámbito, y aplica a todo el tenant. En Pix JD, estos son los [permisos de canal de JD](https://docs.lerian.studio/es/platform/access-manager/features/partners/pix-jd.md#jd-as-a-partner).
* Cuando un producto marca una dimensión como obligatoria, un socio con permisos en ese producto necesita una entrada de ámbito para ella. Sin ella, Access Manager rechaza el socio con `IDE-0001`.
* Fuera de una entrada de permisos reservados, un socio alcanza solo lo que sus permisos **y** su ámbito permiten a la vez.
* Cuando un producto publica qué dimensiones lleva cada una de sus rutas, el Access Manager rechaza un permiso que ninguna solicitud del socio puede usar dentro de su ámbito. El rechazo es `400` con `IDE-1052`, y su mensaje nombra el producto, el recurso y la acción.
* Access Manager no verifica que los valores del ámbito existan en el producto. Guarda los valores que ingresas. Cópialos de la API o de la Console del propio producto.
* No puedes eliminar un socio que tiene aplicaciones. Elimina primero sus aplicaciones.
* Access Manager rechaza un permiso por encima del techo con `IDE-1043`. La Console lo marca como **Not allowed**.

## Cómo se decide una solicitud

***

Cada solicitud que una aplicación del socio envía a un producto se verifica contra el registro del socio, en este orden. La primera verificación que falla decide la respuesta:

1. **Dirección de red.** La dirección de quien llama se verifica contra la lista de IP propia del socio, o contra la lista de tu tenant cuando el socio no tiene una.
2. **Estado.** El socio debe estar `active`.
3. **Ventana de validez.** La solicitud debe estar dentro de la ventana de validez del socio.
4. **Permisos.** El producto, el recurso y la acción deben estar en los permisos del socio.
5. **Ámbito.** Los elementos que la solicitud nombra deben estar dentro del ámbito del socio. Un permiso que el producto reserva para socios omite esta verificación.

Las dos últimas verificaciones dan la misma respuesta, así que un socio no puede usar un rechazo para saber qué elementos existen fuera de su ámbito. Las tres primeras verificaciones también se aplican cuando el socio pide un token. La página de cada producto lista los códigos que recibe el socio.

## Cuándo se aplica un cambio

***

Todo cambio que haces en un socio se aplica sin un token nuevo: sus permisos, su ámbito, su estado, su ventana de validez y su lista de IP.

## Próximos pasos

***

> [card] [Gestiona socios en la Console](https://docs.lerian.studio/es/platform/access-manager/features/partners/console.md)
>
> Crea un socio paso a paso, crea sus aplicaciones, suspéndelo o elimínalo.

> [card] [Gestiona socios por API](https://docs.lerian.studio/es/platform/access-manager/features/partners/api.md)
>
> Las operaciones de socios, sus campos, ejemplos y códigos de error.

> [card] [Socios en Midaz](https://docs.lerian.studio/es/platform/access-manager/features/partners/midaz.md)
>
> Restringe un socio a una organización y a sus ledgers, cuentas o rutas.

> [card] [Socios en Pix JD](https://docs.lerian.studio/es/platform/access-manager/features/partners/pix-jd.md)
>
> Restringe un socio a un participante directo o a un participante indirecto.

> [card] [Lista de IP permitidas](https://docs.lerian.studio/es/platform/access-manager/features/ip-allowlist/overview)
>
> La lista de direcciones de red confiables de tu tenant.

> [card] [Lista de errores](https://docs.lerian.studio/es/reference/platform/access-manager/access-manager-error-list.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.