Kontakt-Tools

Vorschau

Verbundene Anwendungen sind derzeit nur für ausgewählte Konten freigeschaltet.

Sechs Tools verwalten deine Domain-Kontakte, also die Personen und Organisationen, die deine Domains als Inhaber- und Admin-Kontakt nennen. Was Kontakte sind und warum sie nicht dein Konto sind, steht unter Domains.

Die Tools

Tool	Was es tut	Braucht
handle_list	Listet deine Kontakte und ob ihre E-Mail-Adresse und Telefonnummer bestätigt sind, 5 je Aufruf. Alle Angaben nur bei deinen Standardkontakten	handle:read
handle_create	Legt eine Person oder Organisation an und gibt sie ohne die übergebenen Angaben zurück	handle:write
handle_update	Ändert einen Kontakt. Jedes Feld wird mitgeschickt, die unveränderten nennst du der Anwendung aus dem Portal	handle:write
handle_verify_request	Schickt einem Kontakt einen Code per E-Mail oder SMS. Wohin, nennt es nur bei deinen Standardkontakten	handle:write
handle_verify_confirm	Bestätigt den Code, den du bekommen und weitergegeben hast	handle:write
handle_verify_status	Zeigt, ob ein Kontakt bestätigt ist und ob er wieder fällig ist	handle:read

Ein Tool, das einen Kontakt löscht, gibt es nicht. Kontakte löschst du im Portal.

Organisationsdaten werden unter NIS2 im WHOIS (RDDS) veröffentlicht. Deshalb soll die Anwendung für eine Organisation eine Funktionsadresse wie domains@ statt einer persönlichen vorschlagen.

Was eine Anwendung von einem Kontakt sieht

Alle Angaben bekommt eine Anwendung nur von deinen Standardkontakten, im Portal als Account Handle markiert: der Person, die mit deinem Konto angelegt wurde, und, wenn dein Konto eine Organisation hat, dieser Organisation. Jeder andere Kontakt kann Daten einer anderen Person enthalten, und die gibt ITSH an keine Anwendung weiter.

Angabe	Standardkontakt	Jeder andere Kontakt
Kennung, Typ, Land und ob E-Mail-Adresse und Telefonnummer bestätigt sind	Ja	Ja
Firmenname einer Organisation	Ja	Ja
Name, Anschrift, Telefon- und Faxnummer, E-Mail-Adresse	Ja	Nein

Ein anderer Kontakt kommt mit details_withheld und einem panel_link auf die Kontaktseite im Portal, wo du die fehlenden Angaben siehst. Die Felder fehlen dann, sie sind nicht leer. Das hat Folgen für die anderen Tools:

• handle_create gibt den neuen Kontakt so zurück, wie handle_list ihn listet, also ohne die Angaben, mit denen er angelegt wurde.
• handle_update macht den Kontakt zu dem, was geschickt wird, und braucht deshalb jedes Feld. Die unveränderten bekommt die Anwendung nicht von handle_list, sondern von dir: Du siehst sie im Portal.
• handle_verify_request nennt die teilweise maskierte Adresse oder Nummer, an die der Code ging, nur bei deinen Standardkontakten.

Eine E-Mail-Adresse oder Telefonnummer bestätigen

1. Die Anwendung ruft handle_verify_request mit email oder phone auf.
2. Der Code erreicht dich per E-Mail oder SMS. Du nennst der Anwendung den Code.
3. Die Anwendung ruft handle_verify_confirm mit dem sechsstelligen Code auf.

Regel	Wert
Code gültig per E-Mail	15 Minuten
Code gültig per SMS	10 Minuten
Falsche Eingaben, bis ein Code verbraucht ist	5
Eine neue Anfrage	Ersetzt den vorherigen Code
SMS gehen an	Mobilnummern im EWR, in der Schweiz, im Vereinigten Königreich oder im Land deines Kontos
SMS je Konto	5 pro Tag
Erneut bestätigen	Ein Jahr nach der Bestätigung der E-Mail-Adresse

Eine Adresse oder Nummer, die woanders in deinem Konto schon bestätigt ist, gilt sofort als bestätigt, und es wird kein Code verschickt. Dasselbe gilt für die eigene Adresse deines Kontos. Der Code wird nie im Aktivitätsprotokoll aufbewahrt, auch nicht als Prüfsumme.

Eine geänderte E-Mail-Adresse oder Telefonnummer muss neu bestätigt werden.

Was sich hier nicht ändern lässt, und warum

Der Inhaber- oder Admin-Kontakt einer Domain. Über diese Tools lassen sich nur Telefon- und Faxnummer ändern. Name, Organisation, Anschrift und E-Mail-Adresse sind die des Domaininhabers, und wer eine Domain hält, entscheidest allein du. Eine Anwendung, die es versucht, bekommt registrant_change_requires_panel und einen Link auf die Kontaktseite im Portal.

Deine Standardkontakte. Sie folgen den eigenen Daten deines Kontos und lassen sich nicht einzeln ändern, weder von einer Anwendung noch im Portal. Die Ablehnung, default_contact_follows_account, verlinkt deine Kontodaten.

Mehr als 25 Kontakte. Ein Konto hat höchstens 25. Darüber hinaus verlinkt contact_limit_reached die Kontaktseite, wo du einen löschst, den du nicht mehr brauchst.

Weitere Ablehnungen

Code	Meldung	Was zu tun ist
invalid_postcode	The postcode does not have the country's postcode format.	Postleitzahl korrigieren
postcode_state_mismatch	The postcode is not in the given state.	Den ISO-3166-2-Code des Bundeslands prüfen
invalid_code	The code is wrong, has expired, or is used up after five wrong tries.	Code prüfen oder einen neuen anfordern
contact_changed	The contact's address or number changed while it was being verified, or this default contact does not hold the account's phone number yet.	Einen neuen Code anfordern. Bei einem Standardkontakt deine Kontodaten im Portal noch einmal speichern
phone_already_in_use	This phone number is already verified on another ITSH account.	Eine andere Nummer nehmen
phone_not_mobile	The number cannot receive a verification SMS: only mobile numbers in the EEA, Switzerland, the United Kingdom or the account's own country can.	Stattdessen die E-Mail-Adresse bestätigen
too_many_requests	Too many codes were requested for this address or number in the last hour.	Eine Stunde warten
too_many_failures	Too many wrong codes were entered for this contact, address or number today.	Einen Tag warten
sms_daily_limit	This account's verification SMS for today are used up.	Per E-Mail bestätigen oder bis zum nächsten Tag (UTC) warten
sms_unavailable	Verification SMS cannot be sent for the rest of the day.	Per E-Mail bestätigen oder es am nächsten Tag (UTC) versuchen

Limits

Limit	Wert
Auflisten, Anlegen und Ändern	5 Anfragen pro Minute je Konto
Anlegen und Ändern	20 pro Stunde für alle verbundenen Anwendungen zusammen, getrennt von deinen eigenen Änderungen im Portal
Codes	10 E-Mail-Codes und 5 SMS-Codes pro Stunde je Konto, geteilt mit dem Portal
Registrar-Aufrufe	Auflisten 1 je Kontakt, der in den letzten 2 Minuten nicht gelistet wurde, Anlegen 2, Ändern 4, eine Code-Anfrage oder Bestätigung 1, aus den 6 pro Minute des Kontos
Zeit je Aufruf	45 Sekunden; 10 für handle_verify_status

Ein Aufruf von handle_create, der in das Zeitlimit läuft, hat den Kontakt vielleicht trotzdem angelegt. Die Anwendung sollte die Kontakte deshalb auflisten, bevor sie es noch einmal versucht.

Wie es weitergeht

• Domains für das, wofür Kontakte da sind
• Verbindungen verwalten für das, was jede Änderung festgehalten hat