# 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

    1
    2
    3
    4
    5
    6
    7
    8
    <?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

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    <?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

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    <?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

    1
    2
    3
    4
    5
    6
    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

    1
    2
    3
    4
    5
    6
    7
    8
    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

    1
    2
    3
    4
    5
    6
    7
    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