Configurar el acceso de API en el Centro de partners

Artículo
11/27/2023

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

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 acceder a las API, su inquilino debe ser un inquilino de CSP y usted, un proveedor indirecto o un partner de factura directa.

Definiciones de las cuentas

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

Cuenta de partner principal

Esta cuenta es la que usas para crear 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 tratarán como pedidos oficiales para clientes reales. Se reflejarán en la factura y su empresa es responsable de pagarlos.

Cuenta de espacio aislado de integración

Esta cuenta es para probar el código y su integración con las API del Centro de partners antes de su implementación general. Los cambios y las transacciones que haga cuando haya iniciado sesión en la cuenta de espacio aislado de integración aparecerán en su factura, no obstante, no deberá pagar el importe de la factura. El archivo PDF de la factura incluirá una declinación de responsabilidades con el mensaje siguiente: "NO REALICE EL PAGO. ESTA FACTURA CORRESPONDE A UN ESPACIO AISLADO Y NO SE REQUIERE NINGUNA ACCIÓN".

La cuenta de espacio aislado de integración y la cuenta principal actúan de forma independiente y no comparten cuentas de administrador, cuentas de usuario, clientes, pedidos, suscripciones u otros datos.

El espacio aislado de integración admite transacciones con un número limitado de clientes, pedidos, suscripciones, licencias, etc.

Por directiva, las cuentas de espacio aislado de integración solo tienen fines de prueba de integración.

De manera predeterminada, no hay ninguna cuenta de espacio aislado de integración. Debes crear una si vas a usar el SDK de Centro de partners.

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 de Centro de partners.

Creación de un espacio aislado de integración

Inicie sesión en el Centro de partners con una cuenta de administrador global y seleccione Configuración (engranaje).

Nota:

La creación de un espacio aislado requiere que el asociado Global Administración inicie sesión en el Centro de partners con su alias de dominio onmicrosoft.com (por ejemplo, alias@domain.onmicrosoft.com). Se producirá un error en la creación del espacio aislado si el usuario ha iniciado sesión con su dominio personalizado.
Seleccione Configuración de la cuenta y, a continuación , Espacio aislado de integración.

Nota:

Si no ves ninguna opción de espacio aislado de integración, significa que es posible que no tengas ninguna cuenta de administrador global. También es posible que uses una cuenta de espacio aislado de integración y que ya hayas configurado un espacio aislado de integración.
Escribe la información de contacto para la cuenta de administrador de espacio aislado de integración. Luego, elige Crear cuenta. Espera unos minutos para recibir un mensaje de confirmación de que se ha creado la cuenta.
Después de ver el mensaje de confirmación, cierra sesión del Panel del asociado.
Vuelve a iniciar sesión con la nueva cuenta de administrador de espacio aislado de integración. Asegúrese de usar el formato username@domain de sus credenciales junto con la contraseña que ha especificado.
Elija Configurar cuenta en la página Espacio aislado de integración para completar la configuración de la cuenta de espacio aislado.

Habilitación del acceso a la API

Una vez configurada la cuenta, debe habilitar el acceso a la API antes de poder usar el SDK del Centro de partners con el espacio aislado de integración. Tienes que habilitar el acceso a la API por separado para tus cuentas de partner principal y de espacio aislado de integración.

Inicie sesión en el Centro de partners con una cuenta de administrador global y seleccione Configuración (engranaje).
Seleccione Configuración de la cuenta y, a continuación , Administración de aplicaciones.
Si aún no tienes ninguna aplicación, agrega una nueva aplicación web. Si ya tienes una aplicación web, elige el botón Agregar clave.
Copia la información de registro de la aplicación, especialmente la clave si estás creando una aplicación web, y almacénala en un lugar seguro.
Cierra la sesión de Panel del asociado.
Vuelve a iniciar sesión con la nueva cuenta de espacio aislado de integración. Repite los pasos del 2 al 5 para habilitar el acceso a las API en el espacio aislado de integración.

Escritura y prueba de código

Puedes escribir y probar código en el espacio aislado de integración. Necesitará la siguiente información para configurar la autenticación del Centro de partners con el identificador de Microsoft Entra.

Nombre del artículo	Ubicación del elemento
Id. de aplicación/Id. de cliente	En Configuración (engranaje), seleccione Configuración de la cuenta y, a continuación, Administración de aplicaciones. El id. de aplicación o de cliente se muestra como el id. de aplicación registrada.
Clave	Si has creado una aplicación web en la sección Habilitar el acceso a las API, esta es la clave que guardaste en el paso 5.
Dominio	Dominio para el espacio aislado de integración.

Ejecución de código probado

Para usar la solución con datos reales de clientes, debes cambiar tus credenciales de espacio aislado de integración por las de tu cuenta de partner principal.

Cuando esté listo para usar el código probado en la cuenta de partner principal, debe obtener 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).

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).
Reemplaza el token de seguridad de integración en el código por el nuevo token de seguridad de tu cuenta de partner principal.