PrĆ³xima release
Esta documentaĆ§Ć£o Ć© referente a prĆ³xima release do Portal Ćnico Siscomex. Ainda nĆ£o se encontra disponĆvel em produĆ§Ć£o, podem haver diferenƧas entre esta documentaĆ§Ć£o e a documentaĆ§Ć£o da release atual e este conteĆŗdo estĆ” sujeito Ć mudanƧas antes da publicaĆ§Ć£o final. A documentaĆ§Ć£o da release atual pode ser acessada em https://docs.portalunico.siscomex.gov.br/ .
Chaves de Acesso
Com o recurso de Chaves de Acesso, os usuĆ”rios poderĆ£o compartilhar suas credenciais de acesso ao Portal Ćnico de ComĆ©rcio Exterior para consumo da API de serviƧos por meio de sistemas terceiros. As chaves geradas sĆ£o gerenciadas pelo prĆ³prio usuĆ”rio final logado com seu certificado digital.
Roteiro de GeraĆ§Ć£o
A funcionalidade pode ser acessada por meio de um botĆ£o em formato de chave Ć direita no cabeƧalho do portal.
Ao clicar no botĆ£o, a seguinte tela de consulta serĆ” apresentada.
A tela de inclusĆ£o pode ser acessada pelo botĆ£o com sinal "+" localizado Ć direita. A seguinte tela de cadastro serĆ” exibida.
:
Nessa tela, deverĆ£o ser informados os seguintes campos:
-
Tipo de chave: Os intervenientes privados poderĆ£o gerar chaves de Pessoa FĆsica ou JurĆdica. Ao selecionar o tipo Pessoa JurĆdica, serĆ” apresentada uma lista de empresas as quais o usuĆ”rio possui permissĆ£o para gerenciar chaves de acesso. Para o tipo Pessoa FĆsica a chave serĆ” associada Ć sua prĆ³pria credencial.
-
Perfis: Esse campo restringe os perfis que poderĆ£o ser utilizados na autenticaĆ§Ć£o com a chave gerada. A seleĆ§Ć£o do perfil nesse campo nĆ£o representa, necessariamente, a liberaĆ§Ć£o no perfil. A verificaĆ§Ć£o do perfil de fato, acontecerĆ” na chamada de autenticaĆ§Ć£o.
-
DescriĆ§Ć£o: A descriĆ§Ć£o deve ser usada para identificar o objetivo e destino da chave a fim de facilitar a gestĆ£o na tela de consulta.
-
Tempo de expiraĆ§Ć£o: A chave de acesso poderĆ” ser usada durante o tempo de vida definido nesse campo. O encerramento antecipado da validade poderĆ” ser feito atravĆ©s da aĆ§Ć£o de revogaĆ§Ć£o disponĆvel na tela de consulta.
Ao acionar o botĆ£o Salvar e aceitar o termo de responsabilidade, serĆ” apresentada a seguinte tela contendo o par de chaves gerado.
Conforme exibido na mensagem, a responsabilidade pela guarda segura Ć© do usuĆ”rio. A recomendaĆ§Ć£o Ć© que os sistemas de terceiros forneƧam meios seguros para o usuĆ”rio informar o seu par de chaves ou alguma aplicaĆ§Ć£o de compartilhamento de senhas. Deve-se evitar o envio dessas chaves por email.
Depois de gerada, as chaves ficarĆ£o acessĆveis na consulta conforme tela abaixo:
Nessa tela serĆ£o exibidas as chaves de Pessoa FĆsica geradas pelo usuĆ”rio e as de Pessoa JurĆdica geradas pelo prĆ³prio e demais integrantes do quadro societĆ”rio.
A aĆ§Ć£o Visualizar exibe o par de chaves. Com isso, nĆ£o Ć© necessĆ”rio armazenar cĆ³pias em arquivos locais.
A aĆ§Ć£o Revogar finaliza, imediatamente, a vigĆŖncia do par de chaves nĆ£o permitindo mais o seu uso.
Uso das Chaves de Acesso (sistemas de terceiros)
Na documentaĆ§Ć£o dos serviƧos de autenticaĆ§Ć£o estĆ£o descritos os detalhes de uso do par de chaves. Ao se autenticar, o sistema terceiro terĆ” acesso ao perfil do usuĆ”rio podendo acessar os serviƧos do portal como se fosse o proprietĆ”rio da chave.
O recomendado Ć© que o sistema terceiro nĆ£o armazene localmente a chave de acesso do usuĆ”rio. Se optar por armazenar em banco de dados, recomenda-se tomar o devido cuidado de gravar de forma criptografada.