CREATE-AUTHINFO2 Request

Function

The request is used to create an AuthInfo2 for a domain.

Any DENIC member can request a generation of an AuthInfo2 for a domain. DENIC then generates a password and sends it by post to the current domain owner at the address stored in DENIC's database.

Requirements

  • The AuthInfo2 has to be between 8 and 16 characters long.

  • The hash must be created using only the SHA-256 algorithm, without a salt and with a single iteration.

Request Parameters

A request consists of the fields of the “Chprov” data object and the following additional parameters, which are described below:

K/V Keyword XML Namespace and Element Occurrence min - max Type / Length Value Range Description
Action domain:createAuthInfo2 1 enumeration creauthinfo2-erule This is the request type.
Version - 1 enumeration version-erule This is the version. The keyword is only relevant for requests in the key/value format.
CtId ctid 0 - 1 token
3 - 64 		Any visible Unicode character (according to Unicode version 3.1) This is the unique transaction ID which is issued by the client.

Common Mistakes

An AuthInfo2 has already been stored.

Features

  • An existing AuthInfo1 will persist.
  • The administering RegAcc receives a message (either via RRI queue or via e-mail) informing it that an AuthInfo2 has been created for one of its domains.
  • Only one AuthInfo2 can be stored for each domain.
  • All domain holders receive a letter. The AuthInfo2 letters are sent worldwide.
  • All domain holders receive the same Authinfo2.
  • Maximum validity of an AuthInfo2 is 30 days. Upon expiration of this period, the AuthInfo will be deleted automatically.
  • When the domain is deleted, an existing AuthInfo2 for the domain is also deleted.

  • An AuthInfo2 can be stored for any existing domain independent of its status ("connect","failed" or “redemptionPeriod”).

  • If an AuthInfo2 is deposited for a domain in the “failed” status, the corresponding notification letter will indicate the expiration date of the domain.
  • If an AuthInfo2 is stored for a domain with „redemptionPeriod“ status, the term of the Redemption Grace Period is set anew to 30 days.
  • For a domain in the status "redemptionPeriod", an AuthInfo2 can only be requested until midnight on the day of the purge release.

    NOTICE

    Example:
    Redemption Grace Period = 30 Days

    1. August: DELETE
    20. August: CREATE-AUTHINFO2
    31. August: Ende der Redemption Grace Period
    19. September: Ende der Redemption Grace Period

 

Examples

Copy

request:CREATE-AUTHINFO2
format:kv

Version: 5.0
Action: create-authinfo2
Ctid: cba-987654321
Domain: de-example.de
Copy

response:CREATE-AUTHINFO2
status:connect
format:kv

Result: success
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
Copy

response:CREATE-AUTHINFO2
status:serverHold
format:kv

Result: success
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

 

Copy

request:CREATE-AUTHINFO2
format:xml

<?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:createAuthInfo2>
    <domain:handle>de-example.de</domain:handle>
  </domain:createAuthInfo2>
  <ctid>987654321</ctid>
</registry-request>
Copy

response:CREATE-AUTHINFO2
status:connect
format:xml

<?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
Copy

response:CREATE-AUTHINFO2
status:serverHold
format:xml

<?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