Saltar al contenido principal
Esta guía muestra cómo gestionar socios 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, Socios en Pix JD, Socios en Reporter y Socios en Flowker.
  • 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: 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.