Criar o Canal Oracle iOS
Você pode configurar o canal para se conectar ao Oracle Chat Server de dois modos: modo não autenticado e modo autenticado (para proteger o acesso ao canal).
- Modo não autenticado – Use o modo não autenticado quando o cliente não puder gerar tokens JWT assinados, quando não houver mecanismo de autenticação em vigor ou quando o widget do cliente já estiver protegido e visível para usuários autenticados.
- Modo autenticado – A autenticação é aplicada usando JWT (JSON Web Tokens). O servidor de backend do cliente gera o token JWT, que é informado para o Oracle iOS SDK. Este token é usado para cada solicitação a um servidor de fala, texto ou anexo do ODA.
ObservaçãoQuando o aplicativo precisa se conectar a um servidor ODA, ele primeiro solicita o token do servidor de backend e, em seguida, adiciona-o ao cabeçalho Autorização. O servidor ODA valida o token, avalia as declarações e, em seguida, abre o soquete ou rejeita a conexão.
Para proteger o acesso ao canal, o token sempre deve ser gerado por um servidor remoto. Ele nunca deve ser gerado pelo aplicativo cliente.O Token JWT tem as seguintes declarações:channelId
euserId
, e os nomes de declaraçõesiat
(hora de emissão) eexp
(tempo de expiração).iat
significa a hora em que o token foi emitido. Deve ser um número que representa os segundos decorridos desde a Era UNIX.exp
deve ser um número que representa os segundos decorridos desde a Era UNIX. Recomendamos a definição do tempo de expiração para pelo menos 30 minutos após o momento de emissão (iat
). O cabeçalho do token é semelhante a este:
Um exemplo de corpo de token tem a seguinte aparência:{ "alg": "HS256", "typ": "JWT" }
{ "iat": 1569828182, "exp": 1569831782, "channelId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "userId": "John" }
Observação
O token ilustrado por este exemplo não está assinado. Os tokens reais são assinados pela Chave Secreta do canal.
Configurar o Canal Oracle iOS
Para configurar o canal Oracle iOS:
- Escolha Desenvolvimento e Canais no menu.
- Escolha Usuários.
- Clique em Adicionar Canal e, em seguida, em Oracle iOS como o tipo de canal.
- Preencha a caixa de diálogo:
- Informe o nome do canal.
- Para conexões autenticadas:
- Ative a opção Autenticação do Cliente Ativada para determinar se o SDK está se conectando a um canal ativado para autenticação do cliente.
- No campo Expiração Máx. do de Token (Minutos), defina o tempo máximo para o token JWT.
- Defina o tempo de expiração da Sessão.
- Para conexões não autenticadas:
- Desative a opção Autenticação do Cliente Ativada.
- Defina o tempo de expiração da Sessão.
- Clique em Criar. O Oracle Digital Assistant gerará o ID do Canal e a Chave Secreta que você precisa para inicializar o SDK. Mantenha-os à mão, pois você precisará dessas informações ao configurar a página HTML para hospedar o widget de chat.
- Roteie o canal para a habilidade ou o assistente digital.
- Alterne Canal Ativado para Ativado.