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

# Gestiona socios en la Console

> Crea un socio paso a paso, crea sus aplicaciones, cambia lo que puede alcanzar, suspéndelo y elimínalo desde Settings en Lerian Console.

Esta guía muestra cómo gestionar [socios](https://docs.lerian.studio/es/platform/access-manager/features/partners/overview) desde la Console. Creas el socio, creas sus aplicaciones y después cambias o terminas su acceso.

## Antes de empezar

***

Para gestionar socios, un usuario necesita los permisos `partners` de `plugin-identity`: `get` para ver Partners en Settings, `post` para crear un socio, `patch` para cambiar uno y `delete` para eliminar uno. Gestionar sus aplicaciones necesita los permisos `applications` `get`, `post` y `delete`. El rol `plugin-identity-editor-role` los tiene todos.

Crear un socio, cambiar sus permisos o su ámbito y crear sus aplicaciones necesitan Access Manager 3.11.0 o posterior. Con una versión anterior, la Console muestra "Requires Access Manager 3.11.0 or later" en lugar de esos controles.

Reúne esta información antes de empezar:

* Los productos que el socio necesita y lo que puede hacer en cada uno.
* Los identificadores de los elementos que el socio puede alcanzar, para cada dimensión que restringes. Cada producto que ofrece restricciones necesita al menos uno. Cópialos de la API o de la Console del propio producto. La Console no verifica que existan.
* Lo que alcanzan las restricciones de cada producto: consulta [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) y [Socios en Flowker](https://docs.lerian.studio/es/platform/access-manager/features/partners/flowker.md).
* Las direcciones de red desde las que llama el socio, si quieres restringirlas.
* Las fechas de inicio y de fin de su acceso, si tiene un límite de tiempo.

## Abre la página Partners

***

**1. Abre Settings**

Haz clic en el ícono de engranaje () en la barra de navegación superior.

**2. Selecciona Partners**

Selecciona **Partners**. El subtítulo dice "Give each customer its own credentials and limit what it can reach."

La tarjeta **Give partners access** de la página de inicio de la Console abre la misma página.

La lista muestra, para cada socio, **Name**, **Status**, **Validity window**, **Applications** y **Creation Date**. El estado es **Active**, **Suspended**, **Expired** o **Not yet valid**. La Console muestra **Expired** y **Not yet valid** a partir de la ventana de validez. Sin socios todavía, la página dice "No partners yet."

## Crea un socio

***

Haz clic en **New partner**. Se abre la página **New partner**, con cinco pasos: **Details**, **Products**, **Scope**, **Permissions** y **Review**. El botón **Continue** se habilita solo cuando el paso actual está completo. El botón **Back** conserva lo que ingresaste. Si haces clic en **Cancel** después de ingresar algo, la Console pregunta "Discard this new partner?". Si sigues un enlace a otra página de la Console después de ingresar algo, pregunta "Discard changes?". No se crea nada hasta que guardas.

**1. Details**

Escribe el **Name** del socio. Debe ser único en tu tenant.

En **Validity window**, completa **Valid from** y **Valid until** si el acceso tiene un límite de tiempo. Deja **Valid from** vacío para empezar ahora. Deja **Valid until** vacío para que nunca expire. Después de la fecha **Valid until** del socio, Access Manager rechaza sus solicitudes, también con un token que ya tiene, y rechaza tokens nuevos.

En **Where it calls from**, elige una opción:

* **Use your organization's IP list**: el socio usa la lista de IP permitidas de tu tenant.
* **Give it its own list**: escribe cada **IP address or CIDR range** y una **Description** opcional. Haz clic en **Add IP** para cada línea nueva.

Cuando un socio tiene su propia lista de IP, esa lista reemplaza la lista de IP del tenant para las solicitudes del socio.

**2. Products**

Elige los productos que el socio puede usar. La lista muestra solo lo que tu tenant puede dar.

Un producto que no acepta socios no está disponible, con uno de estos mensajes:

* "This product isn't ready for partners yet." El producto no publicó su catálogo de ámbito.
* "This product hasn't enabled partner access yet." El catálogo de ámbito del producto no acepta socios.

**3. Scope**

Indica dónde puede actuar el socio en cada producto. Una restricción que el producto exige ya está abierta, con **(Required)** después de su nombre.

Para agregar una restricción, marca **Restrict by** seguido del nombre de la restricción. Escribe un identificador, o varios identificadores separados por comas.

Da al socio al menos una restricción con un ID en cada producto que ofrece restricciones. Hasta entonces, **Continue** queda cerrado.

**4. Permissions**

Marca los recursos y las acciones que el socio puede usar en cada producto. Para dar otro conjunto de acciones sobre otros recursos, haz clic en **Add another line on** seguido del nombre del producto.

La Console ofrece solo lo que tu tenant puede dar. Muestra un motivo junto a cada entrada que no puede guardar:

* **Not allowed**: el rol de editor del producto en tu tenant no tiene este permiso.
* **Outside the scope**: la escritura actúa en un nivel más amplio que el ámbito del socio.
* **Granted twice**: otra línea ya concede la misma acción sobre el mismo recurso.

Un producto puede conceder algunos recursos solo por ID. Cuando marques uno de ellos, lista sus IDs en el paso **Scope**, o **Continue** queda cerrado.

**5. Review**

Lee el resumen en "Check what this partner can and can't do". La parte **Only inside** lista las restricciones. La parte **It can** lista las acciones sobre cada recurso. La parte **It can't** lista lo que queda fuera.

Haz clic en **Save**. La Console crea el socio sin aplicaciones y abre su pestaña **Overview**.

Si Access Manager rechaza el socio, la Console muestra "The Access Manager refused this request". También muestra el motivo y el código de error, y abre el paso que contiene el campo a corregir.

## Crea las aplicaciones del socio

***

Un socio llama a un producto con una aplicación que le pertenece. Crea una aplicación por producto.

**1. Abre la pestaña Applications**

En la lista de socios, haz clic en el socio. Selecciona la pestaña **Applications**.

**2. Crea la aplicación**

Haz clic en **New Application**. En el panel lateral **New application**, elige el **Product**. La lista muestra solo los productos en los que el socio tiene permisos. Completa **Description** y haz clic en **Create application**.

**3. Guarda las credenciales**

El diálogo "Save the credentials" muestra el **Client ID** y el **Client secret**. La Console muestra el client secret solo cuando creas la aplicación. Guárdalo en ese momento. Haz clic en **I've saved the credentials** para cerrar el diálogo.

Las aplicaciones de socios no aparecen en **Settings → Applications**. Aparecen solo en la pestaña **Applications** del socio.

## Cambia un socio

***

Abre el socio desde la lista. La página de detalle tiene cinco pestañas:

| Pestaña | Qué haces ahí |
| - | - |
| **Overview** | Leer los detalles del socio. En el encabezado de la página, **Edit** cambia su nombre y su **Validity window**, y el menú **More actions** lo suspende, lo reactiva o lo elimina. |
| **Permissions** | Agregar o quitar productos, recursos y acciones. |
| **Scope** | Agregar, cambiar o quitar restricciones. Hacer clic en **Add restriction** y elegir el elemento en **Restrict by**. |
| **IPs** | Dar al socio una lista propia, cambiarla o volver a **Use your organization's list**. |
| **Applications** | Crear y eliminar las aplicaciones del socio. |

Guardar en **Permissions** o en **Scope** reemplaza los permisos y el ámbito juntos. **Save** queda cerrado mientras un producto que ofrece restricciones no tiene ninguna restricción con un ID. También queda cerrado mientras un recurso que un producto concede solo por ID no tiene IDs en la pestaña **Scope**.

## Suspende o reactiva un socio

***

En el encabezado de la página, abre el menú **More actions**, haz clic en **Suspend** y confirma. Esto no elimina nada.

Para terminar la suspensión, abre el menú **More actions**, haz clic en **Reactivate** y confirma.

Suspender un socio en Access Manager detiene su acceso, incluidos los tokens que ya tiene. Reactivar el socio dentro de su ventana de validez restaura el acceso con las mismas credenciales.

## Elimina un socio

***

Solo puedes eliminar un socio sin aplicaciones.

**1. Elimina sus aplicaciones**

En la pestaña **Applications**, elimina cada aplicación del socio. Eliminar una aplicación hace que sus tokens dejen de funcionar.

**2. Elimina el socio**

En el encabezado de la página, abre el menú **More actions**, haz clic en **Delete** y confirma con **Delete**. Access Manager también elimina sus permisos, su ámbito y su lista de IP. No puedes deshacerlo.

Si el socio todavía tiene aplicaciones, la Console las lista y ofrece **Go to Applications**.

## Socios que usan la lista de IP de tu tenant

***

Cuando algunos socios no tienen una lista de IP propia, **Settings → Security** muestra un aviso en la pestaña **IP allowlist**. El aviso indica cuántos socios usan la lista de tu tenant, y su botón los lista.


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