Rajapinnan suojaaminen sertifikaatilla

Last modified by Tapio Piironen on 2025/10/24 11:57

Arkaluonteisemmat apit on julkaistava asiakasvarmenteella suojattuna. Lisäksi niihin tulee aina apikey. Julkaisijalla on täysi kontrolli kenelle hän apit julkaisee hyväksymällä tai hylkäämällä apikeyn tilauksia. Julkaisija tekee ensin normaalisti apikeyllä autentikoivan apin. Kun se toimii, tee desingin kautta tai suoraan planiin policy SSL Enforcement.

Mene proxy→entrypoint ja kohdassa jossa palvelun url on esim. /palvelu/ lisää tämän eteen /secure/ niin että lopputulos on /secure/palvelu/ . Kaikki liikenne /secure/-polun kautta suojataan asiakasvarmenteella. Asiakasvarmenteen tilaa kukin apin käyttäjä palvelusta https://api.helsinki.fi/certificateui

Tämän jälkeen apia voi käyttää esim. foo-koneelta  curl --key 20200529foo.it.helsinki.fi.key --cert 20200529foo.it.helsinki.fi.pem -H 'X-Api-Key: aabcdefgh' https://api.helsinki.fi/secure/palvelu/tarkempipolku

Arkaluonteisemmat apit on julkaistava asiakasvarmenteella suojattuna. Lisäksi niihin tulee aina apikey. Julkaisijalla on täysi kontrolli kenelle hän apit julkaisee hyväksymällä tai hylkäämällä apikeyn tilauksia. Julkaisija tekee ensin normaalisti apikeyllä autentikoivan apin. Kun se toimii, mene proxy→entrypoint ja kohdassa jossa palvelun url on esim. /palvelu/ lisää tämän eteen /secure/ niin että lopputulos on /secure/palvelu/ . Kaikki liikenne /secure/-polun kautta suojataan asiakasvarmenteella. Asiakasvarmenteen tilaa kukin apin käyttäjä palvelusta https://api.helsinki.fi/certificateui