Providers
Chave Mobile Digital
Portugese official electronic signature provider.
Chave Mobile Digital
chave móvel digital or Digital Mobile Key is the official portuguese digital signature service.
component
Ready to sign ?
Be ready to enter your PIN code, then you will recieve an OTP code on your mobile phone.
websocket API
Conversational API to sign a PDF with Chave Movel Digital service.
Sample websocket session :
--> connection
<-- { "state": "start" }
--> { "start": "", "auto_screenshot": 1}
<-- { "state": "stage1_input" }
--> { "phone": "+33 607650693", "pin": "1234", "pdf_file_path": "/session/path/to/file.pdf", "jwt": "xxx" }
<-- { "state": "stage1", "status": "OK", "progress": "root_page" }
<-- { "state": "stage1", "status": "OK", "progress": "credentials_page" }
<-- { "state": "stage1_input", "status": "OK", "progress": "upload_page" }
<-- { "state": "stage2", "status": "OK", "progress": "..." }
--> { "screenshot": "" }
<-- { "state": "screenshot", "screenshot": "..." }
<-- { "state": "stage2_input", "status": "OK", "progress": "otp" }
--> { "otp": "12345678" }
<-- { "state": "stage2", "status": "OK", "progress": "..." }
<-- { "state": "done", "status": "OK" }
TODO
Other possible queries :
--> { "upload_local": "..." }
--> { "upload_s3": "..." }
--> { "ping": "any message ..." }
<-- { "status": "OK", "progress": "any message" }
--> { "screenshot": "" }
<-- { "status": "OK", "screenshot": "xxxx" }
misc
usefull links :
- Sign digital documents with professional attributes
- Electronic Invoice Signing Service (SAFE)
- digital signature API java/C++
- Signatures with eID card (citizen signature certificate)
- SO Digitally sign documents using the Citizen Card Digital Mobile Key
- Integration with Digital Mobile Key
manuel steps
- https://www.autenticacao.gov.pt/, click Sign PDF
- https://cmd.autenticacao.gov.pt/Ama.Authentication.Frontend/Processes/DigitalSignature/DigitalSignatureIntro.aspx, click advance
- https://frtend.reg.cmd.autenticacao.gov.pt/Ama.Registry.Frontend/Processes/DigitalSignature/DocumentSigning.aspx
- click to choose PDF to sign
- click Upload document
- click YES (doc confirmation)
- Click to submit (no visual signature)
- Enter phone number and pin, click Authenticate
- https://cmd.autenticacao.gov.pt/Ama.Authentication.Frontend/Processes/DigitalSignature/DigitalSignConfirmTan.aspx
- enter PIN recieved by SMS and click confirm
- the signed PDF is downloaded