Auftrag domainCREATE-AUTHINFO1

Funktion

Der Auftrag dient dazu, eine AuthInfo zu einer Domain zu hinterlegen.

Die maximale Gültigkeitsdauer eine AuthInfo beträgt 30 Tage. Nach Ablauf der Gültigkeitsdauer (AuthInfoExpire) wird die AuthInfo automatisch gelöscht.

Voraussetzungen

  • Es kann nur eine AuthInfo1 zu einer Domain hinterlegt werden.
  • Die AuthInfo1 muss zwischen 8 und 16 Zeichen lang sein.
  • Eine AuthInfo1 kann parallel zu einer existierenden AuthInfo2 hinterlegt werden.
  • Nur das verwaltende RegAcc kann eine AuthInfo1 hinterlegen.
  • Sollte für eine Domain im Status „failed“ eine AuthInfo1 hinterlegt werden, wird in der entsprechenden Benachrichtigungs-E-Mail auf den Expire-Zeitpunkt der Domain hingewiesen.
  • Der Hash darf nur durch den SHA-256-Algorithmus erzeugt sein - ohne Salt und mit einer einzigen Iteration.
  • Der Output der Hash-Funktion (256 Bit) ist im Auftrag hexadezimal-kodiert mitzuteilen.

Auftragsparameter

Ein CREATE-AUTHINFO1-Auftrag setzt sich zusammen aus den Feldern des Datenobjekts "Chprov" und weiteren Parametern, die nachfolgend beschrieben werden:

K/V-Schlüsselwort XML-Namensraum und Element Vorkommen
min - max		 Typ / Länge Wertebereich Beschreibung
Action domain:createAuthInfo1 1 enumeration creauthinfo1-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

  • Die angegebene Domain ist nicht in der Verwaltung des beauftragenden RegAccs.
  • Der AuthInfo-Hash wurde falsch kodiert (nicht SHA256).
  • Für die Domain ist bereits eine AuthInfo1 hinterlegt.

Besonderheiten

Eine vorhandene AuthInfo2 bleibt bestehen.

 

Beispiele

  • xml
  • k/v

Kopieren

format: xml
request: domainCREATE-AUTHINFO1

<?xml version="1.0" encoding="UTF-8"?>

<registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:domain="http://registry.denic.de/domain/5.0"> 
  <domain:createAuthInfo1 hash="4213d924230224fd719218b4acbd92f96ebe4344f3d5d1478dede1aa44e4cf4b" expire="20100815">
    <domain:handle>de-example.de</domain:handle>
  </domain:createAuthInfo1>
  <ctid>987654321</ctid>
</registry-request>

 

Kopieren

format: xml
response: domainCREATE-AUTHINFO1
status: connect

<?xml version="1.0" encoding="UTF-8"?>

<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
  <tr:transaction>
    <tr:stid>538f1687-963a-11df-a9e2-9519b5688882</tr:stid>
    <tr:ctid>cba-987654321</tr:ctid>
    <tr:result>success</tr:result>
    <tr:message level="info" code="53000080013">
      <tr:text>Domain "Status" is "connect"</tr:text>
    </tr:message>
    <tr:message level="info" code="16350000041">
      <tr:text>Verification information must be provided for the holder(s) to avoid deletion by</tr:text>
      <tr:argument>2024-12-16T15:45:01+01:00</tr:argument>
    </tr:message>
    <tr:message level="info" code="16350000040">
      <tr:text>Verification information must be provided for the holder(s) to avoid dedelegation by</tr:text>
      <tr:argument>2024-12-09T15:45:01+01:00</tr:argument>
    </tr:message>
  </tr:transaction>
</registry-response

 

Kopieren

format: xml
response: domainCREATE-AUTHINFO1
status: serverHold

<?xml version="1.0" encoding="UTF-8"?>

<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
  <tr:transaction>
    <tr:stid>538f1687-963a-11df-a9e2-9519b5688882</tr:stid>
    <tr:ctid>cba-987654321</tr:ctid>
    <tr:result>success</tr:result>
    <tr:message level="info" code="53000080013">
      <tr:text>Domain "Status" is "serverHold"</tr:text>
    </tr:message>
    <tr:message level="info" code="16350000041">
      <tr:text>Verification information must be provided for the holder(s) to avoid deletion by</tr:text>
      <tr:argument>2024-12-16T15:45:01+01:00</tr:argument>
    </tr:message>
  </tr:transaction>
</registry-response

Kopieren

format: k/v
request: domainCREATE-AUTHINFO1

Version: 5.0
Action: create-authinfo1
Ctid: cba-987654321
Domain: de-example.de
Authinfohash: 4213d924230224fd719218b4acbd92f96ebe4344f3d5d1478dede1aa44e4cf4b
Authinfoexpire: 20100724

 

Kopieren

format: k/v
response: domainCREATE-AUTHINFO1
status: connect

Result: success
STID: 74ba5119-74d1-4ba6-935f-4feb07ddd14d

INFO: 53000080013 Domain "Status" is "connect"
INFO: 16350000040 Verification information must be provided for the holder(s) to avoid dedelegation by [2024-12-09T15:45:01+01:00]
INFO: 16350000041 Verification information must be provided for the holder(s) to avoid deletion by [2024-12-16T15:45:01+01:00]
Stid: 57ebbb10-9590-11df-a9e2-9519b5688882
Ctid: cba-9345345321

 

Kopieren

format: k/v
response: domainCREATE-AUTHINFO1
status: serverHold

Result: success
STID: 74ba5119-74d1-4ba6-935f-4feb07ddd14d

INFO: 53000080015 Domain "Status" is "serverHold"
INFO: 16350000041 Verification information must be provided for the holder(s) to avoid deletion by [2024-12-16T15:45:01+01:00]
Stid: 57ebbb10-9590-11df-a9e2-9519b5688882
Ctid: cba-9345345321