Registrar seu aplicativo para usar a API do OneDrive com o SharePoint Server 2016

Para usar a API do OneDrive com SharePoint Server 2016, você precisa primeiro registrar seu aplicativo e receber uma ID de Cliente para representar seu aplicativo em chamadas de API.

Para registrar, você precisa de uma assinatura do Office 365 e de uma assinatura do Azure para começar. Registre seu aplicativo com o Azure Active Directory e depois solicite permissões para o SharePoint.

1. Obter uma assinatura do Office 365

Se você não tiver um, crie um Site do Desenvolvedor do Office 365. Esse site representa seu {tenant}. Há várias maneiras de criar um:

• Uma subscrição MSDN – está disponível para subscritores do MSDN com Visual Studio Ultimate e Visual Studio Premium.
• Uma subscrição de Office 365 existente – pode utilizar uma subscrição de Office 365 existente, que pode ser qualquer uma das seguintes: Office 365 Midsize Business, Office 365 Enterprise, Office 365 Education, Office 365 Government.
• Avaliação gratuita – pode começar com uma avaliação gratuita de 30 dias ou comprar uma subscrição de programador Office 365.
• Comprar uma subscrição – pode comprar uma subscrição anual de programador por 99,00 $ por ano.

Após a inscrição, utilize o userid resultante (no formato userid@yourdomain.onmicrosoft.com) para iniciar sessão no site do portal onde administra a sua conta. Seu Site do Desenvolvedor do Office 365 é fornecido em seu novo domínio:

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

Para saber mais, confira Obter um Site do Desenvolvedor do Office 365.

2. Configurar um locatário do Azure Active Directory

Você precisará configurar um locatário do Azure AD (Azure Active Directory) e associá-lo a seu Site do Desenvolvedor do Office 365. Um locatário do Azure AD dá acesso ao portal de gerenciamento no Microsoft Azure, onde você pode adicionar usuários, funções e aplicativos.

Você pode usar o locatário do Azure AD que foi criado durante a criação de sua assinatura do Office 365 para registrar e autenticar seus aplicativos. Para acessar essa locatário subjacente de seu Centro de Administração do Office 365, use o procedimento a seguir para criar uma assinatura e gerenciar seu locatário do Azure.

1. Entre em seu locatário do Office 365 e acesse o Centro de Administração do Office 365.
2. No mesmo navegador, abra uma nova guia e entre no Microsoft Azure, navegando até Azure Active Directory. Se você receber uma solicitação para entrar com sua conta organizacional, faça-o e, em seguida, entre com suas credenciais do Office 365.
3. Crie uma nova assinatura do Azure.
4. Depois de criar sua assinatura, escolha Portal.

Agora, você deve ver todos os itens em seu locatário do Azure. Ele lista um único diretório com o nome de seu locatário do Office 365.

Se você já tiver um locatário do Azure AD, associe-o à sua assinatura do Office 365 usando estas etapas:

1. Inicie sessão no portal de Gestão do Microsoft Azure com as credenciais existentes do Azure (por exemplo, o ID da Microsoft, como user@live.com) e navegue para o nó do Active Directory .
2. Escolha o nó Active Directory, depois escolha a guia Diretório e, na parte inferior da tela, escolha Novo. Na próxima caixa de diálogo, escolha Usar diretório existente, marque a caixa de seleção e escolha a marca de seleção no canto inferior direito. Isso leva você de volta ao Portal de Gerenciamento do Azure.
3. Entre com suas informações de assinatura do Office 365. Você será questionado se deseja usar seu diretório com o Azure.
4. Escolha Continuar e uma tela será exibida para confirmar a ação. Agora, escolha Sair agora.
5. Feche o navegador e abra o Portal novamente. Caso contrário, você receberá um erro de acesso negado.
6. Entre novamente em sua assinatura do Azure (por exemplo, com sua ID da Microsoft). Navegue até o nó Active Directory e, em Diretório, deverá ver sua conta do Office 365 listada.

Para saber mais sobre como configurar um locatário do Azure AD, confira Configurar o acesso ao Azure Active Directory para o Site do Desenvolvedor.

3. Registrar o aplicativo com o Azure Active Directory

Para autenticar seu aplicativo, você precisa registrar seu aplicativo com o Azure AD e fornecer alguns detalhes sobre o aplicativo. Você pode registrar seu aplicativo manualmente usando o Portal de Gerenciamento do Azure ou usando o Visual Studio.

Para registrar seu aplicativo manualmente, veja Registrar manualmente seu aplicativo com o Azure AD para que ele possa acessar as APIs do Office 365.

Para registrar seu aplicativo usando o Visual Studio, veja Usar o Visual Studio para registrar seu aplicativo e adicionar as APIs do Office 365.

Depois de registrar seu aplicativo, o Azure AD gerará uma ID do cliente e o segredo do cliente (somente aplicativos web) para seu aplicativo. Você precisará usar essa ID do cliente para obter o token de acesso.

Importante Trate o valor do segredo de seu cliente como você faria com uma senha de usuário. O segredo representa a chave para o seu aplicativo e, se for disponibilizado, pode ser usado para representar seu aplicativo.

Ao registrar seu aplicativo no Portal de Gerenciamento do Azure, você precisará configurar detalhes sobre o seu aplicativo com as seguintes etapas:

1. Especifique se o aplicativo é móvel, para desktop ou Web.
2. Especifique o ponto de extremidade do aplicativo. O Azure usará esse ponto de extremidade para redirecionamento durante a autenticação (ou seja, as URLs de Redirecionamento que seu aplicativo usará durante o processo de logon). Para fins de segurança, todas as URLs de redirecionamento devem estar no mesmo domínio raiz, exceto se o aplicativo for um aplicativo Web. Para aplicativos Web, especifique uma URL de entrada e o URI do aplicativo.
3. Para aplicativos Web, especifique se quer disponibilizar seu aplicativo apenas no locatário do Azure no qual você se registrou ou entre vários locatários.
4. Para os aplicativos Web, gere o segredo do aplicativo e sua duração.
5. Especifique os níveis de permissão exigidos por seu aplicativo dos aplicativos da API do Office 365 no Azure usando permissões de aplicativo. O uso da API do OneDrive ou o seletor de arquivos exige pelo menos Ler arquivos do usuário. Carregar, editar ou compartilhar arquivos exige a permissão Ler e gravar arquivos de usuário.

Para adicionar, remover ou atualizar um aplicativo no Azure AD, veja Adicionar, atualizar e remover um aplicativo.

Agora tudo está configurado para conectar seu aplicativo ao OneDrive for Business. Para saber mais sobre como fazer a autenticação, veja Autenticação e entrada no OneDrive for Business.