PRODAT PUBLIC

h1. Zugänge (Passwörter)

Ticket: ##22403

Damit Passwörter (für syncro, dblink usw.) aus Sicherheitsgründen *nicht* mehr im Code hartkodiert werden müssen, sollen diese im Windows-Schlüsselbund (Windows Credential Manager) des Windows Benutzer vom PostgreSQL-Servers hinterlegt werden.

* dafür gibt es jetzt entsprechende Datenbankfunktionen (Language plpython3u).

* nur die DB-Rolle @postgres@ soll diese DB-Funktionen *direkt* rufen dürfen, daher im Schema @TSystem_security@

* anonsten können diese DB-Funktionen nur von Funktionen mit dem Parameter @SECURITY DEFINER@ gerufen werden

h2. Eintrag im Windows-Schlüsselbund hinzufügen bzw. überschreiben

* Funktion @TSystem_security.credential__set()@

* Rückgabe:

** <code class="sql">true</code> - Eintrag wurde geschrieben

** <code class="sql">false</code> - *kein* Eintrag wurde geschrieben; Eintrag mit Kombination aus Service- und Benutzernamen existierte bereits und sollte nicht überschrieben werden

* Beispiel: <code class="sql">SELECT TSystem_security.credential__set( servicename => 'SyncroKonto', username => 'syncro', userpassword => 'geheim', overwrite_pw => true );</code>

h2. Passwort aus entsprechenden Eintrag im Windows-Schlüsselbund auslesen

* Funktion @TSystem_security.credential__get()@

* Rückgabe:

** <code class="sql"><passwort></code> - Passwort des entsprechenden Eintrags

** <code class="sql">null</code> - es existiert *kein* Eintrag für die gegebene Kombination aus Service- und Benutzernamen

* Beispiel: <code class="sql">SELECT TSystem_security.credential__get( servicename => 'SyncroKonto', username => 'syncro' );</code>

h2. Eintrag im Windows-Schlüsselbund löschen

* Funktion @TSystem_security.credential__delete()@

* Rückgabe:

** <code class="sql">true</code> - entsprechender Eintrag wurde gelöscht

** <code class="sql">false</code> - *kein* Eintrag wurde gelöscht; es existiert *kein* Eintrag für die gegebene Kombination aus Service- und Benutzernamen

* Beispiel: <code class="sql">SELECT TSystem_security.credential__delete( servicename => 'SyncroKonto', username => 'syncro' );</code>

h2. Alle vorhandenen Einträge im Windows-Schlüsselbund auflisten

* Funktion @TSystem_security.credentials__list()@

* Rückgabe:

** setof Record aus @servicename@ (varchar) und @username@ (varchar)

|_.servicename |_.username |

|SyncroKonto   |syncro     |

* Beispiel: <code class="sql">SELECT * FROM TSystem_security.credentials__list() ORDER BY servicename, username;</code>