Skip to content
Snippets Groups Projects

feat(docs): get jwk in SET / Encrypt

Merged Jonas Gröger requested to merge feat/FCON-155-Update-Docs into main
All threads resolved!
Files
11
+ 74
0
---
title: Zustellpunktverwaltung
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import useBaseUrl from '@docusaurus/useBaseUrl';
import ApiLink from '@site/src/components/ApiLink';
# Zustellpunktverwaltung
## Bearbeiten eines Zustellpunktes
Für die Aktualisierung eines Zustellpunktes existieren aktuell folgende Endpunkte:
* Vollständige Aktualisierung eines Zustellpunktes: <ApiLink to="/destinations/{destinationId}" withMethod="put" />
* Partielle Aktualisierung eines Zustellpunktes: <ApiLink to="/destinations/{destinationId}" withMethod="patch" />
Für die Aktualisierung der Schlüssel des Zustellpunktes gibt es folgenden Endpunkt:
* <ApiLink to="/destinations/{destinationId}/keys" withMethod="post"/>
Die Details sind der API-Spec zu entnehmen.
### Beispiele
<Tabs
defaultValue="curl"
values={[
{label: 'curl', value: 'curl',},
{label: 'Self-Service-Portal', value: 'ssp',},
]}>
<TabItem value="curl" label="foo">
#### Aktualisierung des Verschlüsselungsschlüssels eines Zustellpunktes
```shell
$ SERVICE_URL=...
$ JWT_TOKEN=...
$ DESTINATION_ID=...
# Hinzufügen eines Schlüssels zu einer Destination
$ curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $JWT_TOKEN" \
--data '{"kty": "RSA", "kid": "new-encryption-key", "alg": "RSA-OAEP-256", "key_ops": ["wrapKey"], "x5c": ["..."], "e": "AQAB", "n": "..."}' \
"$SERVICE_URL/destinations/$DESTINATION_ID/keys"
# Setzen des Schlüssel-ID als Verschlüsselungsschlüssel
$ curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $JWT_TOKEN" \
--data '{"encryptionKid": "new-encryption-key"}' \
"$SERVICE_URL/destinations/$DESTINATION_ID"
```
</TabItem>
<TabItem value="ssp">
:::caution Hinweis
Über das Self-Service-Portal können Zustellpunkte aktuell noch nicht aktualisiert werden.
:::
</TabItem>
</Tabs>
## Zustellpunkt löschen
Das Löschen von Zustellpunkten kann im Self-Service-Portal durchgeführt werden.
Ein Zustellpunkt kann nur gelöscht werden, wenn kein Client mit diesem verknüpft ist.
Durch einen Klick auf die `Destination-ID` in der Zustellpunktverwaltung öffnet sich die Detailansicht für den ausgewählten Zustellpunkt.
<div class="center">
<img width="600" alt="Detailansicht Zustellpunkt" src={useBaseUrl('/images/ssp/19-Destination-Detailansicht.png')}/>
</div>
Loading