OneNote Integração com a Microsoft

Com o conector de OneNote ação da Microsoft, você pode gerenciar cadernos, seções e páginas da sua conta Microsoft 365 diretamente no Amazon Quick por meio de linguagem natural. O conector usa o Microsoft Graph para OneNote operações.

O Amazon Quick oferece suporte a dois métodos de autenticação para a Microsoft OneNote. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização.

• Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com sua conta Microsoft 365.

• Aplicativo OAuth personalizado — usa um aplicativo gerenciado pelo cliente registrado no Microsoft Entra ID. Essa opção dá à sua organização controle total sobre a configuração do OAuth.

Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Verifique se você tem o seguinte antes de configurar a integração.

• Uma conta ativa do Microsoft 365 com acesso aos OneNote notebooks que você deseja usar.

• Para aplicativo OAuth personalizado: acesso ao Microsoft Entra ID (antigo Azure Active Directory) para registrar um aplicativo e configurar as permissões do Microsoft Graph para. OneNote

• Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

Configurando o Microsoft Entra ID

Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e prossiga para. Configurando o conector no Amazon Quick

Para a autenticação personalizada do aplicativo OAuth, registre um aplicativo no centro de administração do Microsoft Entra e configure as permissões do Microsoft Graph para OneNote (como Notes.ReadNotes.ReadWrite, ou Notes.Read.All conforme necessário). Adicione o URL de retorno de chamada do Amazon Quick https://{region}.quicksight.aws.amazon.com/sn/oauthcallback como um URI de redirecionamento. {region}Substitua pela sua AWS região (por exemplo,us-east-1). Para obter instruções passo a passo, consulte Noções básicas sobre autenticação e autorização na documentação do Microsoft Graph. Registre o ID do aplicativo (cliente) e um valor secreto do cliente — você precisa deles ao configurar o Amazon Quick.

Configurando o conector no Amazon Quick

Conecte-se a partir da guia Disponível

Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.

1. No console do Amazon Quick, escolha Conectores.

2. Na guia Disponível, OneNotelocalize e escolha Connect.

3. Conclua o fluxo de login da Microsoft e conceda as permissões solicitadas.

Em vez disso, para configurar um conector com o aplicativo OAuth personalizado, use a guia Criar para sua equipe, conforme descrito abaixo.

Crie a partir da guia Criar para sua equipe

1. No console do Amazon Quick, escolha Conectores.

2. Escolha a guia Criar para sua equipe.

3. Encontre e escolha OneNote.

4. Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.

5. Em Tipo de conexão, escolha Rede pública.

6. Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.

   1. Para o aplicativo OAuth padrão:

      Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.

   2. Para o aplicativo OAuth personalizado, configure os seguintes campos:

      • URL base (opcional) — A URL base do Microsoft Graph. Exemplo: https://graph.microsoft.com/v1.0

      • ID do cliente — A ID do aplicativo (cliente) do registro do aplicativo Microsoft Entra ID.

      • Cliente OAuth público (opcional) — Selecione essa opção se o aplicativo Microsoft Entra ID estiver configurado como um cliente público (sem segredo do cliente).

      • Segredo do cliente — O valor secreto do cliente do registro do aplicativo Microsoft Entra ID.

      • URL do token — O endpoint do token da plataforma de identidade da Microsoft. Exemplo: https://login.microsoftonline.com/common/oauth2/v2.0/token

      • URL de autorização — O endpoint de autorização da plataforma de identidade da Microsoft. Exemplo: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

      • URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.

      nota

      Para autenticação específica do inquilino, common substitua o URL do token e o URL de autorização pelo ID de inquilino do Microsoft Entra ID.

7. Escolha Próximo.

8. Uma janela de login da Microsoft é aberta. Revise as permissões solicitadas e escolha Aceitar.

9. Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.

10. Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

11. Selecione Publish.

Ações disponíveis

Depois de configurar o conector, as ações expostas por OneNote ficam disponíveis. Para ver o conjunto atual de ações do seu conector, acesse a visualização de ações disponíveis do conector no console do Amazon Quick.

Gerenciamento e solução de problemas

Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.

Problemas de autenticação

• Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado) — Verifique se sua conta Microsoft 365 está ativa e se você pode entrar diretamente OneNote na web. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu aplicativo Microsoft Entra ID corresponde ao URL de retorno de chamada do Amazon Quick.

• Permissões insuficientes — Verifique se as permissões do Microsoft Graph configuradas em seu aplicativo Microsoft Entra ID incluem os OneNote escopos necessários para as operações que você deseja usar e se o consentimento do administrador foi concedido, se necessário.

• Credenciais de cliente inválidas (aplicativo OAuth personalizado) — Verifique se a ID do cliente e o segredo do cliente correspondem aos valores no registro do aplicativo Microsoft Entra ID. Confirme se o segredo do cliente não expirou.