Saltar al contenido principal
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.

​
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. 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:

​
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.
  • 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

Gestiona socios en la Console

Crea un socio paso a paso, crea sus aplicaciones, suspéndelo o elimínalo.

Gestiona socios por API

Las operaciones de socios, sus campos, ejemplos y códigos de error.

Socios en Midaz

Restringe un socio a una organización y a sus ledgers, cuentas o rutas.

Socios en Pix JD

Restringe un socio a un participante directo o a un participante indirecto.

Lista de IP permitidas

La lista de direcciones de red confiables de tu tenant.

Lista de errores