Trading Widget

Trading Widget Autenticación

Usa partner-token para nuevas integraciones de trading SSO embebidas.

Ver como Markdown

partner-token evita poner tokens cortos en las URLs y mantiene apiSecret en el backend del partner.

1const widget = TradingWidget.create('#trading-widget', {
2  baseUrl: 'https://app.6mm.com',
3  auth: {
4    mode: 'partner-token',
5    tokenProvider: async ({ channelId, symbol, reason }) => {
6      const resp = await fetch('/api/trading/embed-token', {
7        method: 'POST',
8        credentials: 'include',
9        headers: { 'Content-Type': 'application/json' },
10        body: JSON.stringify({ channelId, symbol, reason }),
11      })
12
13      if (!resp.ok) {
14        throw new Error('Failed to request embed token')
15      }
16
17      return resp.json()
18    },
19  },
20})

Flujo de backend

1. Partner frontend receives auth_request from the iframe.
2. SDK calls tokenProvider.
3. Partner frontend calls its own backend.
4. Partner backend validates the partner session.
5. Partner backend calls 6MM Agent API or Java SDK createEmbedToken.
6. SDK sends embedToken to the iframe through postMessage.
7. iframe exchanges embedToken for a 6MM access token.
8. iframe continues initialization and emits ready.

tokenProvider contrato

CampoDirecciónDescripción
channelIdSDK -> Backend de sociosIdentificador único de sesión de widget. El backend debería pasárselo a createEmbedToken.
SímboloSDK -> Backend de sociosSímbolo de intercambio solicitado actualmente. Úsalo para el alcance del token cuando sea necesario.
RazónSDK -> Backend de sociosPor qué el SDK solicita un token, como la carga inicial o la actualización.
embedTokenBackend de socios -> SDKToken de corta duración creado por el Agent SDK o Agente API.
expireAtBackend de socios -> SDKLa marca de tiempo de expiración del token devuelta por 6MM.

Manejo de fallas

CondiciónManejo recomendado
Sesión en pareja expiradaDevuelve el 401 desde el endpoint del socio y pide al usuario que inicie sesión de nuevo.
La creación de tokens falló temporalmenteLanza un error en tokenProvider y permite que el widget muestre un error de autenticación.
channelId desajusteRechaza la solicitud y recrea la instancia del widget.
El usuario no tiene permitido operarDevuelve un error controlado por el socio y no crees un token embed.

Modo de compatibilidad: agente-sso

Agent-SSO mantiene el flujo antiguo de tickets de entrada de agente. Prefiero partner-token para nuevas integraciones.

1const widget = TradingWidget.create('#trading-widget', {
2  baseUrl: 'https://app.6mm.com',
3  auth: {
4    mode: 'agent-sso',
5    entryUrlProvider: async ({ redirectPath }) => {
6      const resp = await fetch('/api/trading-entry', {
7        method: 'POST',
8        credentials: 'include',
9        headers: { 'Content-Type': 'application/json' },
10        body: JSON.stringify({ redirectPath }),
11      })
12      const data = await resp.json()
13      return data.webUrl
14    },
15  },
16})