Auftrag Contact UPDATE
Funktion
Der Auftrag dient dazu, die Daten eines bereits vorhandenen Contacts zu ändern.
Voraussetzungen
Der Auftrag kann nur durchgeführt werden, wenn der entsprechende Contact bereits existiert.
Besonderheiten
-
Pflichtfelder müssen, auch wenn sie identisch bleiben, immer angegeben werden.
-
Durch das Weglassen von Schlüsselwörtern bei Key/Value werden vorhandene Werte dieser Schlüsselwörter gelöscht.
-
Wird ein Contact in einer Domain, auf der ein Dispute-Eintrag liegt, als "Holder" eingesetzt, so können mit einem UPDATE nicht alle Daten (Name, Organisation, Address, PostalCode, City und Country) geändert werden. In diesem Fall muss sich der RegAcc an Business Services wenden.
Verifikation
- Verifikationsinformationen werden einem vorhandenen Kontakt vom Typ PERSON oder ORG hinzugefügt, geändert oder wieder entfernt.
- Verifikationsinformationen können wieder gelöscht werden, indem bei einem Update keine Informationen dazu angeben werden.
- Ein Contact UPDATE-Auftrag löst einen neuen Verifizierungsvorgang für eine Domain aus, Syntax- und Vollständigkeits-Check und die Risikobewertung werden erneut durchgeführt.
- Die Contact-Handles des Domainbestands werden nicht systematisch gescannt, um für alle Domains eine Risikobewertung zu ermitteln. Davon ausgenommen sind anlassbezogene Überprüfung einzelner Bestandsdomains.
- Sollte eine anlassbezogene Überprüfung ein verdächtiges oder sehr hohes Risiko ergeben, muss eine Verifikation im Rahmen eines Domain-Auftrags durchgeführt werden, was eine Aktualisierung des Kontakts bedeutet.
- Verifikationsinformationen können auch bei einem Contact für eine Domain, für die ein DISPUTE-Verfahren läuft, angelegt oder geändert werden.
Typ des Contacts
Der Typ des Contacts kann mit einem UPDATE geändert werden:
-
von PERSON auf ORG oder
-
von ORG auf PERSON.
Hinweis Bei Contacts, die bei einer Domain verwendet werden, auf die eine DISPUTE gesetzt ist, kann der Contact-Typ nicht geändert werden.
Auftragsparameter
Ein Auftrag setzt sich zusammen aus den Feldern des Datenobjekts "Contact" und weiteren Parametern, die nachfolgend beschrieben werden:
K/V-Schlüsselwort | XML-Namensraum und Element | Vorkommen min - max |
Typ / Länge | Wertebereich | Beschreibung |
---|---|---|---|---|---|
Action | contact:update | 1 | enumeration | update-erule | Auftragstyp |
Version | - | 1 | enumeration | version-erule | Version, nur für Aufträge im Key/Value-Format relevant. |
CtId | ctid | 0 -1 | token 3 - 64 | Jedes sichtbare Unicode-Zeichen (nach Unicode Version 3.1) | Eindeutige Transaktions-ID vom Client |
Häufige Fehler
Das im Auftrag angegebene Contact-Handle existiert nicht.
Beispiele
Beispielaufträge PERSON oder ORG
Response K/V Contact UPDATE
Action: UPDATE
Version: 5.0
Handle: DENIC-1000002-MAX
Type: Person
Name: Max Mustermann
Organisation: DENIC eG
Address: Business Services
Address: Theodor-Stern-Kai 1
Address: The maximum number of
Address: address lines is five and
Address: one line may be 255 characters long.
PostalCode: 60596
City: Frankfurt am Main
CountryCode: DE
eMail: email-1@denic.de
eMail: email-2@denic.de
eMail: email-3@denic.de
eMail: email-4@denic.de
eMail: email-5@denic.de
eMail: email-6@denic.de
Phone: +49.6927235x290
[VerificationInformation]
VerifiedClaim: name
VerifiedClaim: address
VerificationResult: success
VerificationReference: ABC123/45GHT
VerificationTimestamp: 2023-11-11T15:36:21+02:00
VerificationEvidence: idcard
VerificationMethod: auth
TrustFramework: de_denic
[VerificationInformation]
VerifiedClaim: email
VerificationResult: failed
VerificationReference: 354546TZQ
VerificationTimestamp: 2023-10-04T12:22:19+02:00
VerificationEvidence: transaction_log
VerificationMethod: auth
TrustFramework: de_denic
Response XML Contact UPDATE
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:contact="http://registry.denic.de/contact/5.0" xmlns:verification="http://registry.denic.de/verification/5.0">
<contact:update>
<contact:handle>DENIC-1000002-MAX</contact:handle>
<contact:type>PERSON</contact:type>
<contact:name>Max Mustermann</contact:name>
Die Struktur im XML-Dokument nach "contact:name" ist identisch zur Struktur eines Auftrags mit dem RRI-Protokoll 4.0 und kann von dort übernommen werden.
Response XML Contact UPDATE
<verification:verificationInformation xsi:type="verification:verificationInformationType">
<verification:verifiedClaims>
<verification:claim>name</verification:claim>
<verification:claim>address</verification:claim>
</verification:verifiedClaims>
<verification:verificationResult>success</verification:verificationResult>
<verification:verificationReference>ABC123/45GHT</verification:verificationReference>
<verification:verificationTimestamp>2023-11-11T15:36:21+00:00</verification:verificationTimestamp>
<verification:verificationEvidence>idcard</verification:verificationEvidence>
<verification:verificationMethod>auth</verification:verificationMethod>
<verification:trustFramework>de_aml</verification:trustFramework>
</verification:verificationInformation>
<verification:verificationInformation xsi:type="verification:verificationInformationType">
<verification:verifiedClaims>
</verification:claim>email<verification:claim>
</verification:verifiedClaims>
<verification:verificationResult>failed</verification:verificationResult>
<verification:verificationReference>354546TZQ</verification:verificationReference>
<verification:verificationTimestamp>2023-10-04T12:22:19+00:00</verification:verificationTimestamp>
<verification:verificationEvidence>transaction_log</verification:verificationEvidence>
<verification:verificationMethod>auth</verification:verificationMethod>
<verification:trustFramework>eidas</verification:trustFramework>
</verification:verificationInformation>
Die Struktur im XML-Dokument vor "contact:update" ist identisch zur Struktur eines Auftrags mit dem RRI-Protokoll 4.0 und kann von dort übernommen werden.
Response XML Contact UPDATE
</contact:update>
<ctid>cba-987654321</ctid>
</registry-request>
Datenobjekte PERSON oder ORG
K/V-Schlüsselwort | XML-Namensraum und Element |
Vorkommen min - max |
Typ / Länge | Wertebereich | Beschreibung | Policy |
---|---|---|---|---|---|---|
Handle | contact:handle | 1 | token 9 - 32 | contact-rule |
Eindeutige ID des Contacts, Syntax: <RegAccId>-<ID vom Mitglied> |
Das Handle eines Contacts muss immer mit der eigenen RegAccId des verwaltenden RegAccs beginnen. |
Type | contact:type | 1 | enumeration | role-erule | Typ
des Contacts:
|
|
Name | contact:name | 1 | normalizedString 1 - 255 | name-rule | Name des Contacts | Der Name kann nach dem Anlegen nicht mehr geändert werden |
Organisation | contact:organisation | 0 - * | normalizedString 1 - 255 | organisation-rule | Organisation, für die der Contact tätig ist |
|
Address | contact:address | 1 - * | normalizedString 1 - 255 | address-rule | Straße und die Hausnummer des Contacts | Nicht änderbar, sofern der Contact als Holder von einer Domain referenziert wird, die mit einem DISPUTE belegt ist. |
PostalCode | contact:postalCode | 1 | token 1 - 20 | postalcode-rule | Postleitzahl der Anschrift des Contacts | Nicht änderbar, sofern der Contact als Holder von einer Domain referenziert wird, die mit einem DISPUTE belegt ist. |
City | contact:city | 1 | normalizedString 1 - 80 | city-rule | Wohnort des Contacts | Nicht änderbar, sofern der Contact als Holder von einer Domain referenziert wird, die mit einem DISPUTE belegt ist. |
CountryCode | contact:countryCode | 1 |
Enumeration 2 |
country-erule | Countrycode des Landes, in dem der Wohnort des Contacts liegt. |
|
contact:email | 1 - * | normalizedString 3 - 255 |
email-rule (siehe RFC5322 - Internet Message Format) |
E-Mail-Adresse des Contacts | „email“ ist ein Pflichtfeld und muss bei Contact CREATE- und Contact UPDATE-Aufträgen für die Typen PERSON und ORG mindestens einmal angegeben werden. |
K/V-Schlüsselwort | XML-Namensraum und Elemente | 1. Verschachtelung | 2. Verschachtelung | Vorkommen min - max pro Verifizierungsinformations-Block |
Typ / Länge | Wertebereich | Beschreibung |
---|---|---|---|---|---|---|---|
[VerificationInformation] |
<verification:verificationInformation xmlns:verification="http://registry.denic.de/verification/5.0" xsi:type="verification:verificationInformationType"> <verification:verifiedClaims> <verification:verificationResult> <verification:verificationReference> <verification:verificationTimestamp> <verification:verificationEvidence> <verification:verificationMethod> </verification:verificationInformation> |
- |
- |
Einmal pro Verifikationsdatensatz |
- |
- |
Bei K/V: Kopfzeile, die dem Verifikationsdatensatz voran steht |
- |
- |
<verification:verifiedClaims> <verification:claim> </verification:verifiedClaims> |
- |
- |
- |
- |
- |
VerifiedClaim | - |
- |
<verification:claim> ... <verification:claim> |
1 - 3 | normalizedString / feste Länge durch vordefinierte Werte |
claim-rule | "claims" sind Daten, die verifiziert wurden. Besonderheit bei E-Mail Der komplette Verifizierungsinformations-Block mit allen Schlüsselwörten bzw. XML-Elementen und Werten muss bei einer E-Mail-Prüfung angegeben werden, wenn das Ergebnis der Prüfung negativ war, also den Wert "failed" hat. Eine nachfolgendes Update mit dem positiven Wert "success" muss ebenfalls mitgeteilt werden. War bei der Prüfung von Anfang der Wert "success" vorhanden kann der Verifizierungsinformations-Block mitgeteilt werden. |
VerificationResult | - |
<verification:verificationResult> ... </verification:verificationResult> |
- |
1 | normalizedString / feste Länge durch vordefinierte Werte |
result-rule | Mitteilung über das Ergebnis der Verifikation |
VerificationReference | - |
<verification:verificationReference> ... /verification:verificationReference> |
- |
1 | normalizedString / Länge wird vom Mitglied festgelegt |
reference-rule | Der Inhalt ist ein Freitext für eine Referenz auf eine Auftragsnummer, Bestellnummer, Kundennummer etc. |
VerificationTimestamp | - |
<verification:verificationTimestamp> ... </verification:verificationTimestamp> |
- |
1 | date-time | timestamp-rule | Zeitpunkt, zu dem die Verifikation durchgeführt wurde. |
VerificationEvidence | - |
<verification:verificationEvidence> ... </verification:verificationEvidence> |
- |
1 | normalizedString / feste Länge durch vordefinierte Werte |
evidence-rule | Nachweis, der bei der Verifikation geprüft wurde (z.B. für den Wert "idcard", was dem Personalausweis entspricht) |
VerificationMethod | - |
<verification:verificationMethod> ... </verification:verificationMethod> |
- |
1 | normalizedString / feste Länge durch vordefinierte Werte |
method-rule | Methode, mit der die Verifikation durchgeführt wurde (z.B. für den Wert "pvr", was der Nachweis über die Methode "Video-Identifikation" wäre |
TrustFramework | - |
<verification:trustFramework> ... </verification:trustFramework> |
- |
1 | normalizedString / feste Länge durch vordefinierte Werte |
framework-rule | Framework, das zu Verifikation herangezogen wurde. Bisher gibt es nur den Wert "de_denic", ggfs. folgen später weitere. |
Datenobjekt REQUEST
K/V-Schlüsselwort | XML-Namensraum und Element |
Vorkommen min - max |
Typ / Länge | Wertebereich | Beschreibung | Policy |
---|---|---|---|---|---|---|
Handle | contact:handle | 1 | token 9 - 32 | contact-rule | Eindeutige ID des Contacts. Syntax: <RegAccId>-<ID vom Mitglied> | Das Handle eines Contacts muss immer mit der eigenen RegAccId des verwaltenden RegAccs beginnen. |
Type | contact:type | 1 | enumeration | role-erule | REQUEST = eine E-Mail oder eine URL im URI-Template-Format. | Für General Request und Abuse Contact darf Type nur REQUEST sein. |
URI-Template | contact:uri-template | 1 |
normalizedString 8 - 1024 |
Aufbau siehe gemäß RFC 6570 - URI Template | Die Variablen "Ulabel" und "Alabel" im URI-Template werden bei Domainabfrage (Web-whois) mit der Domain ersetzt. | Der Inhalt des URI-Templates wird bei einem CREATE-Auftrag als Test in eine URL oder E-Mail umgewandelt (Für "Alabel" und "Ulabel" wird eine Beispieldomain verwendet.) um die syntaktische Korrektheit zu überprüfen. |