Class: FactPulse::SignatureLectroniqueApi
- Inherits:
-
Object
- Object
- FactPulse::SignatureLectroniqueApi
- Defined in:
- lib/factpulse/api/signature_lectronique_api.rb
Instance Attribute Summary collapse
-
#api_client ⇒ Object
Returns the value of attribute api_client.
Instance Method Summary collapse
-
#generer_certificat_test_api_v1_traitement_generer_certificat_test_post(generate_certificate_request, opts = {}) ⇒ GenerateCertificateResponse
Générer un certificat X.509 auto-signé de test Génère un certificat X.509 auto-signé pour les tests de signature électronique PDF.
-
#generer_certificat_test_api_v1_traitement_generer_certificat_test_post_with_http_info(generate_certificate_request, opts = {}) ⇒ Array<(GenerateCertificateResponse, Integer, Hash)>
Générer un certificat X.509 auto-signé de test Génère un certificat X.509 auto-signé pour les tests de signature électronique PDF.
-
#initialize(api_client = ApiClient.default) ⇒ SignatureLectroniqueApi
constructor
A new instance of SignatureLectroniqueApi.
-
#signer_pdf_api_v1_traitement_signer_pdf_post(fichier_pdf, opts = {}) ⇒ Object
Signer un PDF avec le certificat du client (PAdES-B-LT) Signe un PDF uploadé avec le certificat électronique configuré pour le client (via client_uid du JWT).
-
#signer_pdf_api_v1_traitement_signer_pdf_post_with_http_info(fichier_pdf, opts = {}) ⇒ Array<(Object, Integer, Hash)>
Signer un PDF avec le certificat du client (PAdES-B-LT) Signe un PDF uploadé avec le certificat électronique configuré pour le client (via client_uid du JWT).
-
#signer_pdf_async_api_v1_traitement_signer_pdf_async_post(fichier_pdf, opts = {}) ⇒ Object
Signer un PDF de manière asynchrone (Celery) Signe un PDF uploadé de manière asynchrone via une tâche Celery.
-
#signer_pdf_async_api_v1_traitement_signer_pdf_async_post_with_http_info(fichier_pdf, opts = {}) ⇒ Array<(Object, Integer, Hash)>
Signer un PDF de manière asynchrone (Celery) Signe un PDF uploadé de manière asynchrone via une tâche Celery.
-
#valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post(fichier_pdf, opts = {}) ⇒ Object
Valider les signatures électroniques d'un PDF Valide les signatures électroniques présentes dans un PDF uploadé.
-
#valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post_with_http_info(fichier_pdf, opts = {}) ⇒ Array<(Object, Integer, Hash)>
Valider les signatures électroniques d'un PDF Valide les signatures électroniques présentes dans un PDF uploadé.
Constructor Details
#initialize(api_client = ApiClient.default) ⇒ SignatureLectroniqueApi
Returns a new instance of SignatureLectroniqueApi.
19 20 21 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 19 def initialize(api_client = ApiClient.default) @api_client = api_client end |
Instance Attribute Details
#api_client ⇒ Object
Returns the value of attribute api_client.
17 18 19 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 17 def api_client @api_client end |
Instance Method Details
#generer_certificat_test_api_v1_traitement_generer_certificat_test_post(generate_certificate_request, opts = {}) ⇒ GenerateCertificateResponse
Générer un certificat X.509 auto-signé de test
Génère un certificat X.509 auto-signé pour les tests de signature électronique PDF. ⚠️ ATTENTION : Certificat de TEST uniquement ! Ce certificat est : - ✅ Adapté pour tests et développement - ✅ Compatible signature PDF (PAdES) - ✅ Conforme eIDAS niveau SES (Simple Electronic Signature) - ❌ JAMAIS utilisable en production - ❌ Non reconnu par les navigateurs et lecteurs PDF - ❌ Aucune valeur juridique ## Niveaux eIDAS - SES (Simple) : Certificat auto-signé ← Généré par cet endpoint - AdES (Advanced) : Certificat CA commerciale (Let's Encrypt, etc.) - QES (Qualified) : Certificat qualifié PSCO (CertEurope, Universign, etc.) ## Utilisation Une fois généré, le certificat peut être : 1. Enregistré dans Django (recommandé) : - Django Admin > Certificats de signature - Upload certificat_pem et cle_privee_pem 2. Utilisé directement : - Signer un PDF avec /signer-pdf - Le certificat sera automatiquement utilisé ## Exemple d'appel bash curl -X POST \"https://www.factpulse.fr/api/facturation/generer-certificat-test\" \\ -H \"Authorization: Bearer eyJ0eXAi...\" \\ -H \"Content-Type: application/json\" \\ -d '{ \"cn\": \"Test Client XYZ\", \"organisation\": \"Client XYZ SARL\", \"email\": \"[email protected]\", \"duree_jours\": 365 }' ## Cas d'usage - Tests de signature PDF en développement - POC de signature électronique - Formation et démos - Tests d'intégration automatisés ## Conformité technique Certificat généré avec : - Clé RSA 2048 ou 4096 bits - Algorithme SHA-256 - Extensions Key Usage : digitalSignature, contentCommitment (non-repudiation) - Extensions Extended Key Usage : codeSigning, emailProtection - Validité : 1 jour à 10 ans (configurable) - Format : PEM (certificat et clé) - Optionnel : PKCS#12 (.p12)
27 28 29 30 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 27 def generer_certificat_test_api_v1_traitement_generer_certificat_test_post(generate_certificate_request, opts = {}) data, _status_code, _headers = generer_certificat_test_api_v1_traitement_generer_certificat_test_post_with_http_info(generate_certificate_request, opts) data end |
#generer_certificat_test_api_v1_traitement_generer_certificat_test_post_with_http_info(generate_certificate_request, opts = {}) ⇒ Array<(GenerateCertificateResponse, Integer, Hash)>
Générer un certificat X.509 auto-signé de test Génère un certificat X.509 auto-signé pour les tests de signature électronique PDF. ⚠️ ATTENTION : Certificat de TEST uniquement ! Ce certificat est : - ✅ Adapté pour tests et développement - ✅ Compatible signature PDF (PAdES) - ✅ Conforme eIDAS niveau SES (Simple Electronic Signature) - ❌ JAMAIS utilisable en production - ❌ Non reconnu par les navigateurs et lecteurs PDF - ❌ Aucune valeur juridique ## Niveaux eIDAS - SES (Simple) : Certificat auto-signé ← Généré par cet endpoint - AdES (Advanced) : Certificat CA commerciale (Let's Encrypt, etc.) - QES (Qualified) : Certificat qualifié PSCO (CertEurope, Universign, etc.) ## Utilisation Une fois généré, le certificat peut être : 1. Enregistré dans Django (recommandé) : - Django Admin > Certificats de signature - Upload `certificat_pem` et `cle_privee_pem` 2. Utilisé directement : - Signer un PDF avec `/signer-pdf` - Le certificat sera automatiquement utilisé ## Exemple d'appel ```bash curl -X POST "https://www.factpulse.fr/api/facturation/generer-certificat-test" \ -H "Authorization: Bearer eyJ0eXAi..." \ -H "Content-Type: application/json" \ -d '{ "cn": "Test Client XYZ", "organisation": "Client XYZ SARL", "email": "[email protected]", "duree_jours": 365 }' ``` ## Cas d'usage - Tests de signature PDF en développement - POC de signature électronique - Formation et démos - Tests d'intégration automatisés ## Conformité technique Certificat généré avec : - Clé RSA 2048 ou 4096 bits - Algorithme SHA-256 - Extensions Key Usage : `digitalSignature`, `contentCommitment` (non-repudiation) - Extensions Extended Key Usage : `codeSigning`, `emailProtection` - Validité : 1 jour à 10 ans (configurable) - Format : PEM (certificat et clé) - Optionnel : PKCS#12 (.p12)
37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 37 def generer_certificat_test_api_v1_traitement_generer_certificat_test_post_with_http_info(generate_certificate_request, opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: SignatureLectroniqueApi.generer_certificat_test_api_v1_traitement_generer_certificat_test_post ...' end # verify the required parameter 'generate_certificate_request' is set if @api_client.config.client_side_validation && generate_certificate_request.nil? fail ArgumentError, "Missing the required parameter 'generate_certificate_request' when calling SignatureLectroniqueApi.generer_certificat_test_api_v1_traitement_generer_certificat_test_post" end # resource path local_var_path = '/api/v1/traitement/generer-certificat-test' # query parameters query_params = opts[:query_params] || {} # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept'] # HTTP header 'Content-Type' content_type = @api_client.select_header_content_type(['application/json']) if !content_type.nil? header_params['Content-Type'] = content_type end # form parameters form_params = opts[:form_params] || {} # http body (model) post_body = opts[:debug_body] || @api_client.object_to_http_body(generate_certificate_request) # return_type return_type = opts[:debug_return_type] || 'GenerateCertificateResponse' # auth_names auth_names = opts[:debug_auth_names] || ['HTTPBearer'] = opts.merge( :operation => :"SignatureLectroniqueApi.generer_certificat_test_api_v1_traitement_generer_certificat_test_post", :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type ) data, status_code, headers = @api_client.call_api(:POST, local_var_path, ) if @api_client.config.debugging @api_client.config.logger.debug "API called: SignatureLectroniqueApi#generer_certificat_test_api_v1_traitement_generer_certificat_test_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end |
#signer_pdf_api_v1_traitement_signer_pdf_post(fichier_pdf, opts = {}) ⇒ Object
Signer un PDF avec le certificat du client (PAdES-B-LT) Signe un PDF uploadé avec le certificat électronique configuré pour le client (via client_uid du JWT). Standards supportés : PAdES-B-B, PAdES-B-T (horodatage), PAdES-B-LT (archivage long terme). Niveaux eIDAS : SES (auto-signé), AdES (CA commerciale), QES (PSCO - hors scope). ⚠️ Disclaimer légal : Les signatures générées sont des cachets électroniques au sens du règlement eIDAS. Le niveau de validité juridique dépend du certificat utilisé (SES/AdES/QES). FactPulse ne fournit pas de certificats qualifiés QES - vous devez obtenir un certificat auprès d'un PSCO (Prestataire de Services de Confiance qualifié) pour une validité juridique maximale.
101 102 103 104 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 101 def signer_pdf_api_v1_traitement_signer_pdf_post(fichier_pdf, opts = {}) data, _status_code, _headers = signer_pdf_api_v1_traitement_signer_pdf_post_with_http_info(fichier_pdf, opts) data end |
#signer_pdf_api_v1_traitement_signer_pdf_post_with_http_info(fichier_pdf, opts = {}) ⇒ Array<(Object, Integer, Hash)>
Signer un PDF avec le certificat du client (PAdES-B-LT) Signe un PDF uploadé avec le certificat électronique configuré pour le client (via client_uid du JWT). Standards supportés : PAdES-B-B, PAdES-B-T (horodatage), PAdES-B-LT (archivage long terme). Niveaux eIDAS : SES (auto-signé), AdES (CA commerciale), QES (PSCO - hors scope). ⚠️ Disclaimer légal : Les signatures générées sont des cachets électroniques au sens du règlement eIDAS. Le niveau de validité juridique dépend du certificat utilisé (SES/AdES/QES). FactPulse ne fournit pas de certificats qualifiés QES - vous devez obtenir un certificat auprès d'un PSCO (Prestataire de Services de Confiance qualifié) pour une validité juridique maximale.
117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 117 def signer_pdf_api_v1_traitement_signer_pdf_post_with_http_info(fichier_pdf, opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: SignatureLectroniqueApi.signer_pdf_api_v1_traitement_signer_pdf_post ...' end # verify the required parameter 'fichier_pdf' is set if @api_client.config.client_side_validation && fichier_pdf.nil? fail ArgumentError, "Missing the required parameter 'fichier_pdf' when calling SignatureLectroniqueApi.signer_pdf_api_v1_traitement_signer_pdf_post" end # resource path local_var_path = '/api/v1/traitement/signer-pdf' # query parameters query_params = opts[:query_params] || {} # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept'] # HTTP header 'Content-Type' content_type = @api_client.select_header_content_type(['multipart/form-data']) if !content_type.nil? header_params['Content-Type'] = content_type end # form parameters form_params = opts[:form_params] || {} form_params['fichier_pdf'] = fichier_pdf form_params['raison'] = opts[:'raison'] if !opts[:'raison'].nil? form_params['localisation'] = opts[:'localisation'] if !opts[:'localisation'].nil? form_params['contact'] = opts[:'contact'] if !opts[:'contact'].nil? form_params['field_name'] = opts[:'field_name'] if !opts[:'field_name'].nil? form_params['use_pades_lt'] = opts[:'use_pades_lt'] if !opts[:'use_pades_lt'].nil? form_params['use_timestamp'] = opts[:'use_timestamp'] if !opts[:'use_timestamp'].nil? # http body (model) post_body = opts[:debug_body] # return_type return_type = opts[:debug_return_type] || 'Object' # auth_names auth_names = opts[:debug_auth_names] || ['HTTPBearer'] = opts.merge( :operation => :"SignatureLectroniqueApi.signer_pdf_api_v1_traitement_signer_pdf_post", :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type ) data, status_code, headers = @api_client.call_api(:POST, local_var_path, ) if @api_client.config.debugging @api_client.config.logger.debug "API called: SignatureLectroniqueApi#signer_pdf_api_v1_traitement_signer_pdf_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end |
#signer_pdf_async_api_v1_traitement_signer_pdf_async_post(fichier_pdf, opts = {}) ⇒ Object
Signer un PDF de manière asynchrone (Celery)
Signe un PDF uploadé de manière asynchrone via une tâche Celery. Différence avec /signer-pdf : - /signer-pdf : Signature synchrone (blocage jusqu'à la fin) - /signer-pdf-async : Signature asynchrone (retourne immédiatement un task_id) Avantages de l'async : - Pas de timeout pour les gros fichiers - Pas de blocage du worker FastAPI - Possibilité de suivre la progression via le task_id - Idéal pour les traitements par lot Standards supportés : PAdES-B-B, PAdES-B-T (horodatage), PAdES-B-LT (archivage long terme). ⚠️ Disclaimer légal : Identique à /signer-pdf (voir documentation de cet endpoint).
188 189 190 191 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 188 def signer_pdf_async_api_v1_traitement_signer_pdf_async_post(fichier_pdf, opts = {}) data, _status_code, _headers = signer_pdf_async_api_v1_traitement_signer_pdf_async_post_with_http_info(fichier_pdf, opts) data end |
#signer_pdf_async_api_v1_traitement_signer_pdf_async_post_with_http_info(fichier_pdf, opts = {}) ⇒ Array<(Object, Integer, Hash)>
Signer un PDF de manière asynchrone (Celery) Signe un PDF uploadé de manière asynchrone via une tâche Celery. Différence avec /signer-pdf : - `/signer-pdf` : Signature synchrone (blocage jusqu'à la fin) - `/signer-pdf-async` : Signature asynchrone (retourne immédiatement un task_id) Avantages de l'async : - Pas de timeout pour les gros fichiers - Pas de blocage du worker FastAPI - Possibilité de suivre la progression via le task_id - Idéal pour les traitements par lot Standards supportés : PAdES-B-B, PAdES-B-T (horodatage), PAdES-B-LT (archivage long terme). ⚠️ Disclaimer légal : Identique à /signer-pdf (voir documentation de cet endpoint).
204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 204 def signer_pdf_async_api_v1_traitement_signer_pdf_async_post_with_http_info(fichier_pdf, opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: SignatureLectroniqueApi.signer_pdf_async_api_v1_traitement_signer_pdf_async_post ...' end # verify the required parameter 'fichier_pdf' is set if @api_client.config.client_side_validation && fichier_pdf.nil? fail ArgumentError, "Missing the required parameter 'fichier_pdf' when calling SignatureLectroniqueApi.signer_pdf_async_api_v1_traitement_signer_pdf_async_post" end # resource path local_var_path = '/api/v1/traitement/signer-pdf-async' # query parameters query_params = opts[:query_params] || {} # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept'] # HTTP header 'Content-Type' content_type = @api_client.select_header_content_type(['multipart/form-data']) if !content_type.nil? header_params['Content-Type'] = content_type end # form parameters form_params = opts[:form_params] || {} form_params['fichier_pdf'] = fichier_pdf form_params['raison'] = opts[:'raison'] if !opts[:'raison'].nil? form_params['localisation'] = opts[:'localisation'] if !opts[:'localisation'].nil? form_params['contact'] = opts[:'contact'] if !opts[:'contact'].nil? form_params['field_name'] = opts[:'field_name'] if !opts[:'field_name'].nil? form_params['use_pades_lt'] = opts[:'use_pades_lt'] if !opts[:'use_pades_lt'].nil? form_params['use_timestamp'] = opts[:'use_timestamp'] if !opts[:'use_timestamp'].nil? # http body (model) post_body = opts[:debug_body] # return_type return_type = opts[:debug_return_type] || 'Object' # auth_names auth_names = opts[:debug_auth_names] || ['HTTPBearer'] = opts.merge( :operation => :"SignatureLectroniqueApi.signer_pdf_async_api_v1_traitement_signer_pdf_async_post", :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type ) data, status_code, headers = @api_client.call_api(:POST, local_var_path, ) if @api_client.config.debugging @api_client.config.logger.debug "API called: SignatureLectroniqueApi#signer_pdf_async_api_v1_traitement_signer_pdf_async_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end |
#valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post(fichier_pdf, opts = {}) ⇒ Object
Valider les signatures électroniques d'un PDF Valide les signatures électroniques présentes dans un PDF uploadé. Vérifications effectuées : - Présence de signatures - Intégrité du document (non modifié depuis signature) - Validité des certificats - Chaîne de confiance (si disponible) - Présence d'horodatage (PAdES-B-T) - Données de validation (PAdES-B-LT) Standards supportés : PAdES-B-B, PAdES-B-T, PAdES-B-LT, ISO 32000-2. ⚠️ Note : Cette validation est technique (intégrité cryptographique). La validité juridique dépend du niveau eIDAS du certificat (SES/AdES/QES) et du contexte d'utilisation.
269 270 271 272 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 269 def valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post(fichier_pdf, opts = {}) data, _status_code, _headers = valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post_with_http_info(fichier_pdf, opts) data end |
#valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post_with_http_info(fichier_pdf, opts = {}) ⇒ Array<(Object, Integer, Hash)>
Valider les signatures électroniques d'un PDF Valide les signatures électroniques présentes dans un PDF uploadé. Vérifications effectuées : - Présence de signatures - Intégrité du document (non modifié depuis signature) - Validité des certificats - Chaîne de confiance (si disponible) - Présence d'horodatage (PAdES-B-T) - Données de validation (PAdES-B-LT) Standards supportés : PAdES-B-B, PAdES-B-T, PAdES-B-LT, ISO 32000-2. ⚠️ Note : Cette validation est technique (intégrité cryptographique). La validité juridique dépend du niveau eIDAS du certificat (SES/AdES/QES) et du contexte d'utilisation.
279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 |
# File 'lib/factpulse/api/signature_lectronique_api.rb', line 279 def valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post_with_http_info(fichier_pdf, opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: SignatureLectroniqueApi.valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post ...' end # verify the required parameter 'fichier_pdf' is set if @api_client.config.client_side_validation && fichier_pdf.nil? fail ArgumentError, "Missing the required parameter 'fichier_pdf' when calling SignatureLectroniqueApi.valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post" end # resource path local_var_path = '/api/v1/traitement/valider-signature-pdf' # query parameters query_params = opts[:query_params] || {} # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept'] # HTTP header 'Content-Type' content_type = @api_client.select_header_content_type(['multipart/form-data']) if !content_type.nil? header_params['Content-Type'] = content_type end # form parameters form_params = opts[:form_params] || {} form_params['fichier_pdf'] = fichier_pdf # http body (model) post_body = opts[:debug_body] # return_type return_type = opts[:debug_return_type] || 'Object' # auth_names auth_names = opts[:debug_auth_names] || ['HTTPBearer'] = opts.merge( :operation => :"SignatureLectroniqueApi.valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post", :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type ) data, status_code, headers = @api_client.call_api(:POST, local_var_path, ) if @api_client.config.debugging @api_client.config.logger.debug "API called: SignatureLectroniqueApi#valider_signature_pdf_endpoint_api_v1_traitement_valider_signature_pdf_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end |