Código fonte Wiki de Assinatura Eletrônica ou Digital de Peças

Última modificação por Max Antônio Rodrigues de Assis em 21/07/2020, 14:14
  1: ===   ===
  2: 
  3: === Criar Peça ===
  4: 
  5: 
  6: Ao criar uma peça com assinatura digital servidor, trecho do payload:
  7: [[image:body_servidor_1.png]]
  8: \\Criar uma peça com assinatura digital magistrado, trecho do payload:
  9: [[image:body_magistrado.png]]
 10:  
 11: 
 12: Criar uma peça com assinatura digital magistrado e servidor. trecho do payload:
 13: 
 14: [[image:body_servidor_magistrado.png]]
 15: 
 16: 
 17: == Concluir Peça ==
 18: 
 19: 
 20: [[image:concluir_peca.png]]
 21:  
 22: 
 23: 
 24: == Assinar Digitalmente uma Peça ==
 25: 
 26: A requisição para autenticação deve ser feita por método POST para a URL //https:~/~/api.integracao-bnmp.cnj.jus.br/api/public/authenticate//, e deve conter os parâmetros abaixo (configuráveis de acordo com o Tribunal):
 27: 
 28: **autenticação servidor**
 29: 
 30: **[[image:autentica-servidor.png]]**
 31: 
 32: 
 33: **autenticação magistrado**
 34: 
 35: **[[image:autentica_magistrado.png]]**
 36: 
 37: 
 38: Onde username é o nome do seu usuário, password é a senha (todos já informados), o clientId é fixo (bnmp) e o codigoOrgao é um código exclusivo para o seu Tribunal, que para o TJRS é 30.
 39: 
 40: A resposta para essa requisição de autenticação conterá 2 informações: o token JWT e o CSRF. O token JWT deve ser preenchido no header Authorization do HTTP, e o CSRF (X-XSRF-TOKEN e o Cookie) deve ser informado no header apropriado. TODAS as requisições HTTP com o serviço bnmpservice devem estar com esses 3 campos configurados;
 41: 
 42: A URL correta para autenticação é:
 43: 
 44: * //http:~/~/api.integracao-bnmp.cnj.jus.br/api/public/authenticate//
 45: 
 46: (% class="box warningmessage" %)
 47: (((
 48: **ATENÇÃO! Uma vez autenticado usando qualquer uma dessas URLs, todas as demais requisições, devem ser feitas usando a mesma URL. Caso contrário, o token de conexão não valerá. Se autenticou no api.integracao-bnmp.jus.br/api/public/authenticate , então deve enviar todas as demais requisições para o serviço BNMP em api.integracao-bnmp.cnj.jus.br/bnmpservice/api.**
 49: )))
 50: 
 51: Os mesmos 2 tokens gerados acima serão usados nas transações com a API do bnmpservice (api.integracao-bnmp.cnj.jus.br/bnmpservice/api).
 52: 
 53: O resultado (response) de uma autenticação no SCA retornará como resultado a sequência abaixo:
 54: 
 55: [[image:Response-Autenticacao.PNG||alt="Response da Autenticação"]]
 56: 
 57: O tempo de vida dos tokens é de 24 horas.
 58: 
 59: (% class="box infomessage" %)
 60: (((
 61: Por conta de uma opção de implementação no sistema, sempre a primeira autenticação apresentará um erro de nullpointer. Pode ignorar esse erro, e obter os campos JWT e CSRF.
 62: )))
 63: 
 64: Nas requisições de **GET /api/nome_do_servico_da_peca/assinar-magistrado/{id_da_peca}**, **GET /api/nome_do_servico_da_peca/assinar-servidor/{id_da_peca}**, os tokens acima deverão ser passados como Headers do HTTP, no seguinte padrão:
 65: 
 66: * O token_jwt deve ser passado como header “Authorization” do HTTP, e o valor desse header será a palavra reservada “Bearer”, seguido de espaço, e o valor do token_jwt;
 67: * O token_csrf será passado através do header “Cookie”, com valor formatado da seguinte forma: string X-XSRF-TOKEN, sinal de igual e o valor de token_csrf;
 68: * O token_csrf será passado através do header "X-XSRF-TOKEN", com o valor de token_csrf;
 69: * O content-type: application/json
 70: * login
 71: * senha
 72: * dataZoneLocal: Formato UTC
 73: 
 74: ***são os seguintes nomes de serviços das peças:**
 75: 
 76: 1. **mandado-prisaos**
 77: 1. **mandado-internacaos**
 78: 1. **alvara-solturas**
 79: 1. **ordem-desinternacaos**
 80: 1. **guia-recolhimentos**
 81: 1. **guia-internacaos**
 82: 1. **contramandados**
 83: 
 84: Ilustro abaixo os posicionamentos desses campos, usando a ferramenta Postman (https:~/~/www.getpostman.com/):
 85: 
 86: (% class="lead" %)
 87: Campo (header) AUTHORIZATION:
 88: 
 89: [[image:authoriza.png]]
 90: 
 91: (% class="lead" %)
 92: Campo (header) COOKIE:
 93: 
 94: [[image:cookie.png]]
 95: 
 96: (% class="lead" %)
 97: Campo (header) X-XSRF-TOKEN:
 98: 
 99: (% class="lead" %)
100: [[image:1530579231547-405.png||height="45" width="1163"]]
101: 
102: 
103: (% class="lead" %)
104: Campo (header - magistrado / servidor) login, senha , dateZoneLocal :
105: 
106: [[image:headers_assinatura_digital.png]]
107: 
108: 
109: (% class="lead" %)
110: O retorno do endpoint **GET /api/nome_do_servico_da_peca/assinar-servidor/{id_da_peca}**:
111: [[image:resultado_assinardigitalmente_servidor.png]]
112: 
113: 
114: (% class="lead" %)
115: O retorno do endpoint **GET /api/nome_do_servico_da_peca/assinar-magistrado/{id_da_peca}**:
116: 
117: [[image:resultado_assinar-magistrado_.png]]
118: 
119: