Registrar la aplicación para usar la API de OneDrive con SharePoint Server 2016

Para usar la API de OneDrive con SharePoint Server 2016, primero necesita registrar la aplicación y obtener un id. de cliente para representar su aplicación en llamadas API.

Para el registro, necesita una suscripción a Office 365 y una suscripción a Azure para comenzar. Registre la aplicación con Azure Active Directory y, después, solicite permisos de SharePoint.

1. Obtener una suscripción a Office 365

Si no tiene uno, necesita crear un sitio para desarrolladores de Office 365. Este sitio representa su {tenant}. Hay varias maneras de crear uno:

• Una suscripción de MSDN: está disponible para los suscriptores de MSDN con Visual Studio Ultimate y Visual Studio Premium.
• Una suscripción Office 365 existente: puede usar una suscripción Office 365 existente, que puede ser cualquiera de las siguientes: Office 365 Mediana Empresa, Office 365 Enterprise, Office 365 Educación, Office 365 Administración Pública.
• Evaluación gratuita: puede empezar con una evaluación gratuita de 30 días o comprar una suscripción Office 365 desarrollador.
• Comprar una suscripción : puede comprar una suscripción anual para desarrolladores por 99,00 USD al año.

Después de registrarse, use el userid resultante (en el formato userid@yourdomain.onmicrosoft.com) para iniciar sesión en el sitio del portal donde administra la cuenta. Su sitio para desarrolladores de Office 365 se aprovisiona en su nuevo dominio:

http://{tenant}.sharepoint.com.

Para obtener más información, vea Get an Office 365 Developer Site (Obtener un sitio para desarrolladores de Office 365).

2. Configurar un inquilino de Azure Active Directory

Necesitará configurar un inquilino de Azure Active Directory (Azure AD) y asociarlo con su sitio para desarrolladores de Office 365. Un inquilino de Azure AD le proporciona acceso al portal de administración de Microsoft Azure, donde puede agregar usuarios, roles y aplicaciones.

Puede usar el inquilino de Azure AD que se ha creado al crear la suscripción a Office 365 para registrar y autenticar sus aplicaciones. Para tener acceso a este inquilino subyacente desde el Centro de administración de Office 365, usará el siguiente procedimiento para crear una suscripción y administrar el inquilino de Azure.

1. Inicie sesión en su inquilino de Office 365 y vaya al Centro de administración de Office 365.
2. En el mismo explorador, abra una nueva pestaña e inicie sesión en Microsoft Azure dirigiéndose a Azure Active Directory. Si se le pide que inicie sesión con su cuenta de organización, hágalo y, después, inicie sesión con sus credenciales de Office 365.
3. Cree una suscripción a Azure.
4. Después de crear su suscripción, pulse Portal.

Ahora, debería ver todos los elementos en el inquilino de Azure. Muestra un directorio único con el nombre de su inquilino de Office 365.

Si ya tiene un inquilino de Azure AD existente, puede asociarlo a su suscripción a Office 365 siguiendo estos pasos:

1. Inicie sesión en el Portal de administración de Microsoft Azure con las credenciales de Azure existentes (por ejemplo, su identificador de Microsoft, como user@live.com), y vaya al nodo de Active Directory .
2. Seleccione el nodo Active Directory. Después, seleccione la pestaña Directorio y, en la parte inferior de la pantalla, seleccione Nuevo. En el siguiente cuadro de diálogo, pulse Usar directorio existente, active la casilla y, después, seleccione la marca de comprobación en la esquina inferior derecha. Regresará al Portal de administración de Azure.
3. Inicie sesión con la información de su suscripción a Office 365. Se le pedirá si quiere usar su directorio con Azure.
4. Pulse Continuar y aparecerá una pantalla para confirmar la acción. Ahora, seleccione Cerrar sesión ahora.
5. Cierre el explorador y vuelva a abrir el portal. Si no lo hace, obtendrá un error de acceso denegado.
6. Inicie sesión de nuevo en su suscripción a Azure (por ejemplo, con su identificador de Microsoft). Vaya al nodo Active Directory y, en Directorio, debe ver ahora su suscripción a Office 365.

Para obtener más información sobre la configuración de un inquilino de Azure AD, vea Set up Azure Active Directory access for your Developer Site (Configurar el acceso a Azure Active Directory en su sitio para desarrolladores).

3. Registrar su aplicación con Azure Active Directory

Para autenticar la aplicación, necesita registrarla con Azure AD y proporcionar algunos detalles sobre esta. Puede registrar la aplicación manualmente mediante el Portal de administración de Azure o con Visual Studio.

Para registrar la aplicación manualmente, vea Manually register your app with Azure AD so it can access Office 365 APIs (Registrar manualmente su aplicación con Azure AD para que pueda tener acceso a las API de Office 365).

Para registrar la aplicación con Visual Studio, vea Using Visual Studio to register your app and add Office 365 APIs (Usar Visual Studio para registrar la aplicación y agregar las API de Office 365).

Después de que haya registrado la aplicación, Azure AD generará un id. de cliente y un secreto de cliente (solo en aplicaciones web) para la aplicación. Necesitará usar este id. de cliente para obtener el token de acceso.

Importante Trate el valor del secreto de cliente como lo haría con la contraseña de un usuario. El secreto representa la clave de la aplicación y, si está disponible, puede usarse para suplantar la aplicación.

Cuando registre la aplicación en el Portal de administración de Azure, necesitará configurar los detalles de la aplicación con los siguientes pasos:

1. Especificar si la aplicación es una aplicación web, móvil o de escritorio.
2. Especificar el punto de conexión de la aplicación. Azure usará este punto de conexión para el redireccionamiento durante la autenticación (es decir, las URL de redireccionamiento que usará la aplicación durante el proceso de inicio de sesión). Por motivos de seguridad, todas las URL de redireccionamiento deben encontrarse en el mismo dominio raíz, excepto si la aplicación es una aplicación web. Para las aplicaciones web, especifique una dirección URL de inicio de sesión y un URI de aplicación.
3. Para las aplicaciones web, especifique si quiere hacer que su aplicación esté disponible solo en el inquilino de Azure donde la ha registrado o en varios inquilinos.
4. Para las aplicaciones web, genere el secreto de aplicación y su duración.
5. Especifique los niveles de permiso que necesita la aplicación de las aplicaciones de la API de Office 365 en Azure con los permisos de aplicación. Para usar la API de OneDrive o el selector de archivos se necesita al menos el permiso Leer archivos de usuario. Se necesita el permiso Leer y escribir archivos de usuario para cargar, editar o compartir archivos.

Para agregar, quitar o actualizar una aplicación en Azure AD, vea Integración de aplicaciones con Azure Active Directory.

Ahora ha configurado todo para conectar su aplicación a OneDrive para la Empresa. Para obtener información sobre cómo realizar la autenticación, vea OneDrive for Business authentication and sign in (Inicio de sesión y autenticación de OneDrive para la Empresa).