Saltar al contenido principal
Un socio puede llamar a TED Lerian con su propia credencial. Restringes esa credencial a la organización de Midaz y, si quieres, al ledger en el que trabaja TED Lerian. Esta página trata de TED Lerian. Para TED JD, consulta Socios en TED. Todo socio de TED Lerian necesita un alcance.
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 400 e IDE-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.
Un socio puede tener solo estos permisos: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 transfers:read, restringido solo a la organización. Lista las transferencias de la organización del alcance del socio. La respuesta es 200:
Envía la misma solicitud sin el encabezado 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-transfers no las lista.
  • GET /v1/incoming-transfers/{incomingTransferId} y GET /v1/incoming-transfers/{incomingTransferId}/timeline responden 404, como si la TED no existiera.
Las aplicaciones de tu institución siguen viendo estas TED recibidas cuando no actúan por un socio. Usa una de ellas para revisar las TED recibidas que no tienen organización.

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.
Da transfers:create solo a un socio que pueda enviar desde todas las cuentas de la organización. Un socio con este permiso puede enviar desde cualquier cuenta de la organización que indique en X-Account-Id.

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/*.
Usa una aplicación de tu propia institución para estas rutas.

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.