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
1
Abre Settings
Haz clic en el ícono de engranaje () en la barra de navegación superior.
2
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.”
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.
1
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.
2
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.
3
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.
4
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.
5
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.
Emite las credenciales del socio
Un socio sin aplicación no puede llamar a nada. 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. Solo se ofrecen los productos en los que el socio tiene permisos. Completa Description y haz clic en Create application.
3
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.
4
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.
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. 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.
1
Elimina sus aplicaciones
En la pestaña Applications, elimina cada aplicación del socio.
2
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.
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.