Compartir vía


Configurar el acceso a la API en el Centro de partners

se aplica a: Centro de socios | Centro de socios operado por 21Vianet | Centro de socios para Microsoft Cloud para el Gobierno de EE. UU.

En este artículo se describen las cuentas que debes desarrollar en el SDK del Centro de partners. En este artículo también se explica cómo debes crear una cuenta de espacio aislado de integración y realizar pruebas en el espacio aislado de integración.

Nota:

Para obtener acceso a las API, el cliente debe ser un cliente del Proveedor de Soluciones en la Nube (CSP) y debe ser un proveedor indirecto o un socio de facturación directa.

Descripción de las definiciones de cuenta

Para ayudarle a integrar y probar la integración de api, el Centro de partners admite dos tipos de cuentas.

Cuenta de asociado principal

Esta cuenta es donde se crean pedidos reales para clientes reales. Si realiza algún cambio o transacción al iniciar sesión en la cuenta principal, mediante el SDK del Centro de partners o la interfaz de usuario del Panel de partners, se tratan como pedidos oficiales para clientes reales. Se reflejan en la factura y su empresa es responsable de pagarlos.

Cuenta de entorno de pruebas de integración

Esta cuenta es para probar el código y su integración con las API del Centro de partners antes de implementarlo ampliamente. Los cambios y las transacciones que realice al iniciar sesión en la cuenta de espacio aislado de integración aparecen en la factura, pero no tiene que pagar el importe de la factura. El pdf de factura contiene un aviso legal: "NO PAGAR. ESTA FACTURA CORRESPONDE A UN ESPACIO AISLADO Y NO SE REQUIERE NINGUNA ACCIÓN".

  • La cuenta de prueba de integración y la cuenta principal actúan de forma independiente. No comparten cuentas de administrador, cuentas de usuario, clientes, pedidos, suscripciones u otros datos.
  • El entorno de pruebas de integración admite transacciones con un número limitado de clientes, pedidos, suscripciones, licencias, etc.
  • Las cuentas sandbox de integración son solo para fines de pruebas de integración según la política.
  • No existe ninguna cuenta de espacio aislado de integración de manera predeterminada. Debe crear uno usted mismo si planea usar el SDK del Centro de socios.

Configuración de las cuentas

En esta sección se describe cómo configurar una cuenta de partner principal y una cuenta de espacio aislado de integración para el SDK del Centro de partners.

Crea un sandbox de integración

Para crear un espacio aislado de integración, siga los pasos descritos en Creación de una cuenta de espacio aislado de integración del proveedor de soluciones en la nube (CSP).

Habilitación del acceso a la API

Una vez configurada la cuenta, tiene que habilitar el acceso a las API para poder usar el SDK de Centro de partners con el espacio aislado de integración. Debe habilitar el acceso a la API por separado tanto para su cuenta de asociado principal como para su cuenta de sandbox de integración.

  1. Inicie sesión en Centro de partners con una cuenta de administrador global y seleccione Configuración (icono de engranaje).
  2. Seleccione Configuración de la cuentay, después, Administración de aplicaciones.
  3. Si aún no tiene una aplicación existente, agregue una nueva aplicación web. Si tiene una aplicación web existente, elija el botón Agregar clave.
  4. Copie la información de registro de la aplicación, especialmente la clave de si va a crear una aplicación web y almacenarla en un lugar seguro.
  5. Cierre la sesión del Panel de partners.
  6. Vuelva a iniciar sesión con la cuenta de sandbox de integración. Repita los pasos 2-5 para habilitar el acceso a la API en el sandbox de integración.

Escritura y prueba de código

Puede escribir y probar código en el sandbox de integración. Necesita la siguiente información para configurar la autenticación del Centro de partners con un Microsoft Entra ID.

  • id. de aplicación o id. de cliente: se muestra como id. de aplicación registrada en Configuración (icono de engranaje) >Configuración de la cuenta>Administración de aplicaciones.
  • Clave: si creó una nueva aplicación web en la sección anterior, use esa clave.
  • Dominio: es para el espacio aislado de integración.

Ejecución de código probado

Para usar la solución con datos reales de los clientes, debe cambiar de las credenciales del entorno de pruebas de integración a las credenciales de la cuenta de socio principal.

Cuando esté listo para usar el código probado en la cuenta de asociado principal, necesita un token de seguridad de Microsoft Entra. Este token de seguridad se basa en la aplicación del Centro de partners, la clave y el dominio (en lugar de la aplicación de espacio aislado de integración, la clave y el dominio).

  1. Siga los pasos descritos en Autenticación del Centro de partners para obtener un token de seguridad de Microsoft Entra mediante las credenciales del Centro de partners principal. (Anteriormente ha seguido estos pasos para obtener un token de seguridad de Microsoft Entra para el espacio aislado de integración).
  2. Reemplaza el token de seguridad de integración en tu código por el nuevo token de seguridad de la cuenta de socio principal.