Projeto de exemplos em Python com Flask
O Projeto de exemplos em Python com Flask mostra como usar o Rest PKI junto com Web PKI em um projeto Python usando o framework Flask. Está hospedado no GitHub em:
https://github.com/LacunaSoftware/PkiSuiteSamples/tree/master/python/flask
Executando o projeto
- Download do projeto ou clonar o repositório
- Instale as dependências:
pip install -r requirements.txt - Veja o ambiente variável
FLASK_APPpara definir o nome do aplicativo que deve executar:FLASK_APP=sample - Execute a aplicação web:
flask run - Acesse a URL http://localhost:5000
Mapa do projeto
Esta seção mostra onde encontrar partes relevantes em cada amostra de recurso do projeto.
Autentificação com certificação digital
- View: authentication_rest.py
- Templates:
- index.html (JavaScript on signature-form.js)
- success.html
- failed.html
Assinatura PAdES com arquivo já no servidor
- View: pades_signature_rest.py
- Templates:
- index.html (JavaScript on signature-form.js)
- complete.html
Assinatura PAdES com arquivo enviado pelo usuário
Após o upload do arquivo (implementado apenas para demonstração na view server_files.py e template index.html) o fluxo de controle é o mesmo que na amostra Assinatura PAdES com arquivo já no servidor, mas com o parâmetro URL userfile preenchido.
Co-assinatura PAdES
Após o fluxo de controle da amostra Assinatura PAdES com arquivo já no servidor for concluído e o link Co-assinatura com outro certificado for clicado, o mesmo fluxo de controle é repetido, mas agora com o parâmetro URL userfile preenchido.
Marcas PAdES
Não avaliado neste projeto ainda.
Assinatura PAdES usando chave do servidor
Não avaliado neste projeto ainda.
Abrir/Validar uma assinatura PAdES existente
- View: open_pades_rest.py
- Template: index.html
Versão para impressão
Após o fluxo de controle da amostra Assinatura PAdES com arquivo já no servidor estar concluído e o link Download a printer-friendly version of the signed file ser clicado, o fluxo vai para a view printer_version_pades_rest.py com o identificador do arquivo assinado na URL.
Assinatura CAdES com arquivo já no servidor
- View: cades_signature_rest.py
- Templates:
- index.html (JavaScript em signature-form.js)
- complete.html
Assinatura CAdES com arquivo enviado pelo usuário
Após o upload do arquivo (implementado apenas para demonstração na view server_files.py e template index.html) o fluxo de controle é o mesmo que na amostra Assinatura CAdES com arquivo já no servidor, mas com o parâmetro URL userfile preenchido.
Co-assinatura CAdES
Após o fluxo de controle da amostra Assinatura CAdES com arquivo já no servidor for concluído e o link Co-assinatura com outro certificado for clicado, o mesmo fluxo de controle é repetido, mas agora com o parâmetro URL cmsfile preenchido.
Abrir/Validar uma assinatura CAdES existente
Não avaliado neste projeto ainda.
Assinatura XML de um documento inteiro
- View: xml_signature_rest.py
- Templates:
- index.html (JavaScript em signature-form.js)
- complete.html
Assinatura XML de um elemento
- View: xml_nfe_signature_rest.py
- Templates:
- index.html (JavaScript em signature-form.js)
- complete.html
Assinatura XadES de um elemento
Demonstrado no exemplo de diploma digital, que assina os elementos DadosDiploma e DadosRegistro com a política ICP-Brasil XAdES AD-RT e, por fim, o documento inteiro com a política AD-RA:
- View: xml_diploma_signature_rest.py
- Templates:
Lote de assinaturas PAdES
- View: batch_pades_rest.py
- Template: index.html (JavaScript em batch-signature-restpki-form.js)
Lote de assinaturas CAdES
- View: batch_cades_rest.py
- Template: index.html (JavaScript em batch-signature-restpki-form.js)