Necesitas Access Manager v3.20.0 o posterior. Las versiones anteriores no aceptan los permisos de TED Lerian.
Paso a paso
1
Elige dónde actúa el socio
TED Lerian tiene dos restricciones. Las dos se aplican a los recursos
transfers y incoming-transfers:TED Lerian trabaja en una organización y en un ledger: los que están configurados para tu institución. Consulta la configuración en Descripción general de la API de TED Lerian. Pon esa organización, y ese ledger si restringes por ledger, en el alcance del socio.
2
Da al socio sus permisos y su alcance
Crea el socio, o modifícalo, en la Consola o con la API de Identity. El slug del producto es
plugin-br-ted-lerian.- Agrega la entrada de alcance de la organización. Sin una entrada de alcance, Access Manager rechaza el socio con
400eIDE-1060. - Para restringir el socio a un ledger, agrega también la entrada de alcance del ledger.
- Revisa los recursos y las acciones. Lo máximo que puedes dar es lo que tiene el rol de editor de TED Lerian en tu tenant. Por encima de eso, Access Manager rechaza con
IDE-1043.
Access Manager rechaza todos los demás permisos con
400 e IDE-1056. Estos permisos actúan sobre todo el tenant: el desbloqueo y la decisión del análisis de fraude de una transferencia, la devolución y las decisiones sobre una TED recibida, la conciliación, los dashboards, la política y los vínculos de ISPB, la lista de participantes, el catálogo de eventos y la configuración de runtime. Access Manager también rechaza con IDE-1056 los permisos marcados con No para un socio restringido a un ledger. La Consola marca estas líneas como Outside the scope.3
Crea su aplicación de TED Lerian
Crea la aplicación del socio con el producto
plugin-br-ted-lerian. Consulta Crea las aplicaciones del socio en la guía de la API, o en la Consola. Envía el client ID y el client secret al socio por un canal seguro.4
Indica la organización y el ledger en cada solicitud
El socio indica la organización en el encabezado
X-Organization-Id, y el ledger en el encabezado X-Ledger-Id. Los dos encabezados son opcionales para los demás llamadores. Un socio debe enviarlos como muestra esta tabla. Una solicitud sin ellos se rechaza.Los encabezados no eligen la organización ni el ledger. TED Lerian siempre los toma de su configuración, y los encabezados solo los confirman. TED Lerian revisa cada encabezado que lee:
Esta revisión se aplica a todos los llamadores, también a las aplicaciones de tu propia institución.Cuando un envío o una cotización de tarifa tiene
X-Ledger-Id, la cuenta en X-Account-Id debe ser una cuenta de ese ledger. Si no, la respuesta es 400 con TED-0001. TED Lerian también hace esta revisión en un reintento con una clave X-Idempotency que ya usó. No repite una respuesta guardada para una cuenta de otro ledger.5
Confirma que funciona
Usa la credencial de un socio con Envía la misma solicitud sin el encabezado
transfers:read, restringido solo a la organización. Lista las transferencias de la organización del alcance del socio. La respuesta es 200:X-Organization-Id. La respuesta es 403 con TED-0071.La restricción de ledger cubre solo el envío
TED Lerian lee el ledger solo cuando un socio envía una TED u obtiene una cotización de tarifa. Las lecturas, la cancelación y las TED recibidas no llevan ledger. Una transferencia puede estar en un ledger anterior de tu institución, y una TED recibida puede estar en cualquier ledger de los vínculos de ISPB. TED Lerian no las filtra por ledger. Por eso, un socio restringido a un ledger solo puede enviar y obtener cotizaciones de tarifa. Access Manager se niega a darle
transfers:read, transfers:cancel o incoming-transfers:read, con 400 e IDE-1056. Para que un socio pueda leer o cancelar transferencias, restríngelo solo a la organización.
Un socio restringido a la organización lee todas las transferencias y TED recibidas de la organización, en todos los ledgers. Dale transfers:read e incoming-transfers:read solo cuando pueda ver todas ellas.
TED recibidas sin organización
TED Lerian atribuye cada TED recibida a una organización. Una TED recibida que todavía no puede atribuir no tiene organización y espera en
MANUAL_REVIEW. Un socio no ve estas TED recibidas:
GET /v1/incoming-transfersno las lista.GET /v1/incoming-transfers/{incomingTransferId}yGET /v1/incoming-transfers/{incomingTransferId}/timelineresponden404, como si la TED no existiera.
Las reglas del socio en Midaz no valen para sus transferencias
TED Lerian llama a Midaz y al CRM con su propia credencial, también cuando atiende a un socio. Los permisos y el alcance del socio en Midaz no se aplican a estas llamadas. TED Lerian no tiene restricción de cuenta. La cuenta en
X-Account-Id debe pertenecer a la organización de TED Lerian, o la respuesta es 403 con TED-0009. Cuando la solicitud tiene X-Ledger-Id, la cuenta también debe ser una cuenta de ese ledger, o la respuesta es 400 con TED-0001.
Rutas que ningún socio alcanza
Todas las rutas fuera de la tabla del paso 2 actúan sobre todo el tenant. Un socio no puede tener los permisos de estas rutas, así que TED Lerian lo rechaza con
403 y TED-0071:
- El desbloqueo y la decisión del análisis de fraude de una transferencia.
- La devolución, la decisión de revisión y la decisión de la verificación de fraude de una TED recibida.
- Las rutas de conciliación,
/v1/reconciliation/*. - Los dashboards de operaciones,
/v1/operations/*. - La política y los vínculos de ISPB,
/v1/policy/*. - La lista de participantes,
GET /v1/participants. - La configuración de runtime,
/v1/system/*.
Si algo falla
TED-0071 no dice si fueron los permisos o el alcance los que rechazaron la solicitud. Es intencional: un socio no puede usar un rechazo para saber qué organizaciones o ledgers existen fuera de su alcance.
Un cambio en un socio, como una suspensión o un nuevo alcance, se aplica en su próxima solicitud, también con un token que ya tiene. Cuando TED Lerian guarda las decisiones de Access Manager por un tiempo, definido en AUTH_CACHE_TTL, el cambio se aplica después de ese tiempo.
Para todos los demás códigos, consulta la lista de errores de TED Lerian. Para los rechazos al crear o cambiar un socio, consulta Códigos de error en la guía de la API.
