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

> Crea un socio paso a paso, emite sus credenciales, cambia lo que alcanza, suspéndelo y elimínalo desde Settings en Lerian Console.

<Warning>
  Esta funcionalidad está disponible solo en Staging para pruebas y todavía no está disponible en Producción.
</Warning>

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

## Antes de empezar

***

Necesitas el permiso `partners` con la acción `get` para abrir la página. Para crear las credenciales de un socio, también necesitas el permiso `applications` con la acción `post`.

Reúne esta información antes de empezar:

* Los productos que el socio necesita y lo que puede hacer en cada uno.
* Los IDs de los elementos que el socio puede alcanzar: en Midaz, al menos el ID de la organización. Copia los IDs de la propia API o de Console del producto. Console no verifica que existan.
* 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

***

<Steps>
  <Step title="Abre Settings">
    Haz clic en el ícono de engranaje (<Icon icon="gear" />) en la barra de navegación superior.
  </Step>

  <Step title="Selecciona Partners">
    Selecciona **Partners** en la barra lateral de Settings. El subtítulo dice "Give each customer its own credentials and limit what it can reach."
  </Step>
</Steps>

La página lista tus socios. Un socio que no está funcionando muestra una insignia de estado: **Suspended**, **Expired** o **Not yet valid**. Sin socios, la página dice "You haven't registered any partners yet".

## Crea un socio

***

Haz clic en **New partner**. Se abre un asistente con cinco pasos: **Details**, **Products**, **Scope**, **Permissions** y **Review**. **Next** se abre solo cuando el paso actual está completo. **Back** conserva lo que ingresaste.

<Steps>
  <Step title="Details">
    Escribe el **Name** del socio. Solo tu equipo ve este nombre, y 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.

    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 las direcciones o los rangos CIDR del socio. Su lista propia reemplaza la lista de tu tenant. Una dirección que está solo en la lista de tu tenant no funciona para este socio.
  </Step>

  <Step title="Products">
    Elige los productos que el socio puede usar. La lista muestra solo lo que tiene tu tenant.

    Un producto que todavía no acepta socios aparece en gris con el mensaje "This product isn't ready for partners yet." No puedes seleccionarlo.
  </Step>

  <Step title="Scope">
    Indica dónde puede actuar el socio en cada producto. Una restricción que el producto exige ya aparece abierta. En Midaz, es la organización.

    Para restringir el acceso, haz clic en **Add restriction** y elige el elemento en **Restrict by**, por ejemplo un ledger o una cuenta. Escribe un ID, o varios IDs separados por comas.

    Cuando restringes un tipo por ID, el socio no puede listar ni crear elementos de ese tipo.
  </Step>

  <Step title="Permissions">
    Marca los recursos y las acciones que el socio puede llamar en cada producto. Para dar otro conjunto de acciones sobre otros recursos, agrega una línea con el botón del producto, por ejemplo **Add another line on Midaz**.

    Console ofrece solo lo que tu tenant puede dar. Una línea que no se puede guardar muestra su motivo:

    * **Not allowed**: tu tenant no tiene este permiso.
    * **Outside the scope**: la escritura actúa por encima del ámbito del socio. Por ejemplo, crear ledgers actúa sobre toda la organización, así que un socio restringido a un ledger no puede recibirla.
    * **Granted twice**: otra línea ya concede la misma acción sobre el mismo recurso.
  </Step>

  <Step title="Review">
    En "Check what this partner can and can't do", lee el resumen. **It can** lista las acciones, los elementos y la lista de IP. **It can't** lista lo que queda fuera.

    Haz clic en **Save**. Console crea el socio sin credenciales. Las emites en su pestaña **Applications**.
  </Step>
</Steps>

Si Access Manager rechaza el socio, Console muestra "The Access Manager refused this change" y abre el paso que contiene el campo a corregir.

## Emite las credenciales del socio

***

Un socio sin aplicación no puede llamar a nada. Crea una aplicación por producto.

<Steps>
  <Step title="Abre la pestaña Applications">
    En la lista de socios, haz clic en el socio. Selecciona la pestaña **Applications**.
  </Step>

  <Step title="Crea la aplicación">
    Haz clic en **New Application**. En el panel lateral **New application**, elige el **Product**. Solo se ofrecen los productos en los que el socio tiene permisos. Completa **Description** y haz clic en **Create application**.
  </Step>

  <Step title="Copia las credenciales">
    El diálogo "Save the credentials" muestra el client ID y el client secret. Copia los dos ahora. El client secret se muestra una sola vez. Haz clic en **I've saved them** para cerrar el diálogo.
  </Step>

  <Step title="Envía las credenciales al socio">
    Envía el client ID y el client secret al socio por un canal seguro. El sistema del socio los usa para pedir tokens de acceso.
  </Step>
</Steps>

Las aplicaciones de socios no aparecen en **Settings → Applications**. Siguen los permisos, el ámbito, la ventana de validez y la lista de IP del socio.

Si se pierde un client secret, elimina esa aplicación y crea una nueva. Una aplicación nueva trae un secreto nuevo. Cuando eliminas una aplicación, el programa del socio que la usa deja de funcionar al instante.

## Cambia un socio

***

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

| Pestaña | Qué haces ahí |
| - | - |
| **Overview** | Cambiar el nombre del socio, cambiar su **Validity window**, suspenderlo o reactivarlo, y eliminarlo. |
| **Permissions** | Agregar o quitar productos, recursos y acciones. |
| **Scope** | Agregar, cambiar o quitar restricciones. |
| **IPs** | Dar al socio una lista propia, cambiarla o volver a **Use your organization's list**. |
| **Applications** | Crear y eliminar las credenciales del socio. |

Guardar en **Permissions** o en **Scope** reemplaza los permisos y el ámbito juntos. Un cambio se aplica desde la siguiente solicitud del socio.

## Suspende o reactiva un socio

***

En la pestaña **Overview**, haz clic en **Suspend** y confirma. Todas las credenciales del socio se rechazan desde su siguiente solicitud, incluidos los tokens que ya tiene. No se elimina nada.

Para devolver el acceso, haz clic en **Reactivate** y confirma. Las credenciales del socio vuelven a funcionar desde su siguiente solicitud. Son las mismas credenciales de antes.

## Elimina un socio

***

Solo puedes eliminar un socio sin aplicaciones.

<Steps>
  <Step title="Elimina sus aplicaciones">
    En la pestaña **Applications**, elimina cada aplicación del socio.
  </Step>

  <Step title="Elimina el socio">
    En la pestaña **Overview**, haz clic en **Delete partner** y confirma. El socio pierde el acceso al instante. Sus permisos, su ámbito y su lista de IP también se eliminan. No puedes deshacerlo.
  </Step>
</Steps>

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

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

***

En **Settings → Security**, la pestaña **IP allowlist** muestra cuántos socios usan la lista de tu tenant. Un cambio en esa lista también se aplica a esos socios, desde su siguiente solicitud. Para que un socio no dependa de esa lista, dale una lista propia en su pestaña **IPs**.


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