1. Usar SDKs do Oracle Identity Cloud Service para autenticação de aplicativos
  2. Saiba Mais sobre Autenticação entre Aplicativos Web e o Oracle Identity Cloud Service

Saiba Mais sobre Autenticação entre Aplicativos Web e o Oracle Identity Cloud Service

Você está pronto para aprender sobre o seguinte:

  • Quando usar SDKs do Oracle Identity Cloud Service

  • Como esses SDKs funcionam

  • O que você deve saber, ter ou usar antes de usar os SDKs

  • Se o SDK para Java, Node.js ou Python deve ser usado

Quando Usar SDKs do Oracle Identity Cloud Service

Suponha que você queira desenvolver aplicativos Web Java, Node.js ou Python e implantar esses aplicativos em um servidor local ou em um serviço de plataforma baseado na nuvem, como o Oracle Application Container Cloud Service. Você deseja que o Oracle Identity Cloud Service trate as responsabilidades de autenticação de seus aplicativos Web. Você pode fazer isso usando SDKs do Oracle Identity Cloud Service.

Esses SDKs foram testados pela Oracle. Os SDKs encapsulam todas as chamadas de ponto final da API REST que precisam ser feitas pelos aplicativos para autenticar usuários com o Oracle Identity Cloud Service.

Outras vantagens do uso de SDKs incluem:

  • Simplificando a comunicação entre seus aplicativos Web e o Oracle Identity Cloud Service

  • Simplificando como seus aplicativos web trocam códigos de autorização para tokens de acesso do usuário para identificar usuários registrados no Oracle Identity Cloud Service

  • Permitindo que seus usuários acessem seus aplicativos Web por meio do SSO fornecido pelo Oracle Identity Cloud Service

Compreender como os SDKs do Oracle Identity Cloud Service Funcionam

O Java SDK é uma coleção de classes e métodos, e os SDKs Node.js e Python contêm arquivos e funções. Essas coleções são montadas como bibliotecas e estruturas. Tudo o que você precisa fazer é incluir a biblioteca ou o framework do SDK no projeto do seu aplicativo e, em seguida, compilar e implantar o aplicativo em um servidor ou contêiner de aplicativos.

Antes de usar o SDK, você deve registrar seu aplicativo como confiável no Oracle Identity Cloud Service. O Oracle Identity Cloud Service gera um ID de Cliente e um Segredo de Cliente para seu aplicativo. O ID e o Segredo do Cliente são equivalentes a uma credencial (por exemplo, um ID e uma senha) que o SDK usa para se comunicar com o Oracle Identity Cloud Service.

Para se comunicar com o Oracle Identity Cloud Service, o SDK também requer outros detalhes, como:

  • URL do serviço de público: O URL da sua instância do Oracle Identity Cloud Service (por exemplo, https://idcs-abc123456789.identity.oraclecloud.com)

  • Escopo: O acesso necessário ao seu aplicativo durante a comunicação com o Oracle Identity Cloud Service para autenticar usuários (por exemplo, openid)

  • URL de Redirecionamento: O URL de callback do aplicativo, que é usado pelo Oracle Identity Cloud Service para redirecionar o web browser para o usuário depois que o usuário acessa (por exemplo, http://localhost/callback)

Antes de Começar

Os SDKs Java, Node.js e Python do Oracle Identity Cloud Service usam bibliotecas de terceiros. Cada SDK foi validado para funcionar com versões específicas dessas bibliotecas.

Antes de usar um SDK, verifique se as bibliotecas de terceiros associadas ao SDK não estão em conflito com nenhuma outra biblioteca que seu aplicativo Web possa estar usando. Além disso, você deve ter o seguinte:

  • Um conhecimento básico das linguagens de programação Java, Node.js ou Python para entender a lógica do código associado a cada SDK

  • O SDK associado ao idioma do seu aplicativo

  • Acesso a uma instância do Oracle Identity Cloud Service

  • Uma conta de administrador de domínio de identidades ou de aplicativo no Oracle Identity Cloud Service para que você possa registrar seu aplicativo Web como um aplicativo confiável

Decida qual SDK usar

Se você estiver desenvolvendo um aplicativo Web Java, Node.js ou Python e quiser usar o Oracle Identity Cloud Service como mecanismo de autenticação do seu aplicativo, use o SDK associado à linguagem do seu aplicativo.

Se você tiver uma conta de administrador de domínio de identidades ou de administrador de segurança no Oracle Identity Cloud Service, poderá fazer download de SDKs na página Downloads da console do Identity Cloud Service. Para fazer isso:

  1. No console do Identity Cloud Service, expanda a Gaveta de Navegação, clique em Definições e, em seguida, clique em Downloads.

  2. Na página Downloads, clique em Fazer Download à direita do SDK que você deseja fazer download.

Você pode fazer download de SDKs, como arquivos zip, para os seguintes idiomas:

  • Java: Este arquivo compactado contém um arquivo de biblioteca JAR. É necessário adicionar esse arquivo à pasta lib do aplicativo ou instalá-lo no servidor de aplicativos no qual você implanta o aplicativo.

  • Node.js: Este arquivo compactado contém uma pasta de estratégia de passaporte que você deve incluir como parte da pasta node_modules do seu aplicativo.

  • Python: Este arquivo compactado contém dois arquivos python: IdcsClient.py e Constants.py. Você deve adicionar esses arquivos ao projeto do aplicativo.

Para entender como usar cada SDK, a Oracle fornece um aplicativo web de amostra para cada um desses idiomas. O aplicativo de amostra implementa dois casos de uso: um para autenticar um usuário com o Oracle Identity Cloud Service e outro para acessar informações detalhadas do usuário conectado.