Differences

This shows you the differences between two versions of the page.

--- cn:ccr:x509:home:drao:webapi [2020/05/13 17:35] – veraldi@infn.it
+++ cn:ccr:x509:home:drao:webapi [2020/05/13 17:44] (current) – veraldi@infn.it
@@ Line 1: / Line 1: @@
+====== Utilizzo delle Web API ======
+Gran Parte delle operazioni che si effettuano via portale SCM possono essere svolte via Web API e quindi possono essere scriptabili e automatizzate.
+SI RIMANDA ALLA [[https://comodoca.my.salesforce.com/sfc/dist/version/download/?oid=00D1N000002Ljih&ids=0683l00000G8cXM&d=%2Fa%2F3l000000Vb2c%2FRvc6oZaTAlseortnT.fJcKGwDLua5fwAFylH_1Gaqck&asPdf=false|DOCUMENTAZIONE UFFICIALE SECTIGO]] PER UN COMPENDIO ESAUSTIVO
+Per potere utilizzare le Web API bisogna avere un account dedicato abilitato all'utilizzo di queste inoltre bisogna essere a conoscenza di alcuni parametri che servono per effettuare le query:
+  * customerUri
+  * orgid
+  * certType
+  * sslId
+Queste informazioni specifiche per latipologia di certificato e il Dipartimento per il quale si richiede il certificato.
+Le query sono effettuate utilizzando json.
+Alcuni esempi di utilizzo delle API. Nell'esempio sono utilizzati valori fittizi non corrispondenti a valori validi:
+  * customerUri = MYURI
+  * orgid = 111111
+  * certType = 101010
+  * sslId = 3837437
+  * Query che da' come risultato la lista di tutti i certificati per il proprio Dipartimento
+<html>
+<body>
+<pre>
+curl 'https://cert-manager.com/api/ssl/v1/'  -i -X GET -H 'login: username' -H 'Content-Type: application/json' -H 'password: PaSsWoRd' -H 'customerUri: MYURI'
+</pre>
+</body>
+</html>
+  * Query per ottenere informazioni su un particolare certificato (sslId)
+<html>
+<body>
+<pre>
+curl 'https://cert-manager.com/api/ssl/v1/3837437'  -i -X GET -H 'login: username' -H 'Content-Type: application/json' -H 'password: PaSsWoRd' -H 'customerUri: MYURI'
+</pre>
+</body>
+</html>
+  * Query per fare una richiesta di certificato. Prima di sottomettere la richiesta va generato il CSR e il contenuto Base64 encoded va inserito nel Body della richiesta. Ad esempio supponiamo che la richiesta Base64 encoded (formato PEM) sia la sequente:
+<html>
+<body>
+<pre>
+-----BEGIN CERTIFICATE REQUEST-----
+MIICpDCCAYwCAQAwXzEuMCwGA1UECgwlSXN0aXR1dG8gTmF6aW9uYWxlIGRpIEZp
+c2ljYSBOdWNsZWFyZTENMAsGA1UECwwEQ05BRjEeMBwGA1UEAwwVcHJvdmExMDAu
+Y25hZi5pbmZuLml0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA7rCf
+wPb5pm5kwkmqg8nxVWhUAebJBozTFrpIW4Wcc1CzqEcYn2MwP9pPwyG8E/yEZaO5
+hKCPY3lWsMz7YN0PdmoOHl9W9wWpgCh5byn9+bC7EA1G+va97UxGD/ZoEcvW+qga
+CrARGwaEITP8TgKUaaj2/tUSv6f1DuoM1ohEd1I0kf8cKQQMnrp78nNGeahdmHZN
+EKAZU9DrDczUczyvQNwDMAoMZVCoqkRsDE1RQ5ncXfP7CssoC1ojmZQQUsalcGW4
+gUxUklSQZ7USUza3gxXsVT0HOZ5L9lUJEFfxg5uofhAiEkY/SI2bEuVJwM07gUaq
+LOhBG3JtFXU1R/LwIDAQABoAAwDQYJKoZIhvcNAQELBQADggEBAMEvt3RVNUXm
+pOVS5C8IpnIqJe20xEtHDp9boBASuz9bCnLwiEUM0r9AnxvbSFflQcBNkG1LiLn
+a4GCRJS7/fGKA69ckNme+IISVxcuPmNUqz/mFRGtvyV1qCau+Cx5b37Yh6W4OrW+
+AzVpK32cmhWr7DrSBKY7/fxDVAhVEHGR02cppe5OFjxhyx6insGPKvinKR5Su+u
+zkrWhFJl3ksD41K01fL63iDfB/RpKjxhnHq4KtEa5VkcIPkEaDaDeDUKF2FJbkLd
+jEzMYDBcLbye0rh0Jtlv528tA2BJOor+Gp2UjYEkeTJDf+UnW+sPf2EQhud6BCU
+Za9+U13qcW8=
+-----END CERTIFICATE REQUEST-----
+</pre>
+</body>
+</html>
+  * Per sottomettere la richiesta di enrollment con //curl// questa va inserita su una singola riga di comando e il Carriage Return va inserito come carattere'\n' alla fine di ogni riga nel body che contiene la richiesta di certificato:
+<html>
+<body>
+<pre>
+curl 'https://cert-manager.com/api/ssl/v1/enroll'  -i -X POST -H 'login: username' -H 'Content-Type: application/json' -H 'password: PaSwWoRd' -H 'customerUri: MYURI' -d '{"orgId":111111,"subjAltNames":"","certType":101010,"term":365,"csr":"-----BEGIN CERTIFICATE REQUEST-----\nMIICpDCCAYwCAQAwXzEuMCwGA1UECgwlSXN0aXR1dG8gTmF6aW9uYWxlIGRpIEZp\nc2ljYSBOdWNsZWFyZTENMAsGA1UECwwEQ05BRjEeMBwGA1UEAwwVcHJvdmExMDAu\nY25hZi5pbmZuLml0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA7rCf\nwPb5pm5kwkmqg8nxVWhUAebJBozTFrpIW4Wcc1CzqEcYn2MwP9pPwyG8E/yEZaO5\nhKCPY3lWsMz7YN0PdmoOHl9W9wWpgCh5byn9+bC7EA1G+va97UxGD/ZoEcvW+qga\nCrARGwaEITP8TgKUaaj2/tUSv6f1DuoM1ohEd1I0kf8cKQQMnrp78nNGeahdmHZN\nEKAZU9DrDczUczyvQNwDMAoMZVCoqkRsDE1RQ5ncXfP7CssoC1ojmZQQUsalcGW4\ngUxUklSQZ7USUza3gxXsVT0DdJ5L9lUJEFfxg5uofhAiEkY/SI2bEuVJwM07gUaq\n75LOhBG347Fc01R/LwIDAQABoAAwDQYJKoZIhvcNAQELBQADggEBAMEvt3RVNUXm\n7pOVS5C8IpnIqJe20xEtHDp9boBASuz9bCnLwiEUM0r9AnxvbSFflQcBNkG1LiLn\na4GCRJS7/fGKA69ckNme+IISVxcuPmNUqz/mFRGtvyV1qCau+Cx5b37Yh6W4OrW+\n0AzVpK32cmhWr7DrSBKY7/fxDVAhVEHGR02cppe5OFjxhyx6insGPKvinKR5Su+u\nzkrWhFJl3ksD41K0welU4iDfB/RpKjxhnHq4KtEa5VkcIPkEaDaDeDUKF2FJbkLd\n3jEzMYDBcLbye0rh0Jtlv528tA2BJOor+Gp2UjYEkeTJDf+UnW+sPf2EQhud6BCU\nZa9+U13qcW8=\n-----END CERTIFICATE REQUEST-----"}'
+</pre>
+</body>
+</html>