Introdução:
Algumas funcionalidades do Mosia Omnichannel exigem que o beneficiário esteja autenticado. Uma demanda crescente indica que clientes desejam embutir funcionalidades de cartões virtuais em outros portais, diferentes da Mobile Saúde.
Objetivo
Neste documentação vamos exemplificar o passo a passo de como embutir uma funcionalidade que necessita da autenticação.
Importante: é importante que você já possua conhecimento sobre a forma simplificada de embutir funcionalidades, disponíveis neste link.
Passo 1 - obtendo código de embed + liberando origem para renderização
Obtenha o código de incorporação, e autorize a origem da URL conforme documentação de incorporação simples.
O link para a documentação está disponível para que vc realize os passos necessários.
Passo 2 - criando uma chave de segurança para obtenção do token
Após obter os códigos de incorporação e autorizar as origens, será necessário obter o token de autorização de segurança. O token de autorização de segurança é necessário quando for necessária a criação de uma sessão para o usuário da funcionalidade.
Acesse o painel de segurança, e crie uma nova chave de segurança, conforme descrito à seguir:
Menu Segurança / Cadastro de Origens / Nova origem / Escolha a opção “Credencial de API pública”.
Preencha as informações sobre a chave, e no menu “API” escolha “Segurança”. Confirme.
Uma chave será exibida. Guarde-a para uso futuro, baixando-a em seu computador.
Passo 3 - obtendo o token através de uma API pública
Após obter os códigos de incorporação e autorizar as origens, será necessário obter o token de autorização de segurança. O token de autorização de segurança é necessário quando for necessária a
Para obter o token de sessão, consuma a API pública de obtenção de sessão, descrita aqui:
ATENÇÃO
Em caso de testes em ambiente de sandbox é necessário passar o parâmetro “instanciaAplicacao” conforme exemplo abaixo:
<script src="https://omnichannel-sdk.mosiaomnichannel.com.br/"</script>>
<div id="container-ms-4-4"></div>
<script type="text/javascript">
let funcionalidadeS9 = window.omnichannelSDK.embed({
id: "container-ms-4-4",
url: "https://funcionalidades-front.mosiaomnichannel.com.br/",
json: {
idFuncionalidade: 4,
bundle: "HASH",
authorization: null, // opcional para funcionalidades que não necessitam de login
esquemaCor: null, // null pega o default, ou o slug de um esquema qualquer
instanciaAplicacao: 1
}
})
</script>
Conclusão
Agora você está pronto para incorporar a funcionalidade do aplicativo em sua página da web. Siga as etapas descritas acima para obter o código de incorporação, configurar a segurança e adicionar o código à página desejada. Lembre-se de que o recurso de incorporação só funcionará nos domínios registrados na seção de segurança do aplicativo.
Observação: Certifique-se de fornecer todas as informações necessárias para utilizar corretamente o recurso de incorporação em suas páginas da web, incluindo os requisitos de segurança e as instruções de incorporação.