Een DirectAdmin login key aanmaken

DirectAdmin kent geen API-tokens. Het kent login keys: aparte wachtwoorden voor je account die je kunt beperken tot bepaalde commando's en adressen. Je vult je gewone gebruikersnaam in en de key als wachtwoord. Gebruik een key in plaats van je echte wachtwoord. Lekt hij, dan verwijder je de key en je account blijft zoals het was.

Kies het accountniveau

Het account waarop je de key maakt bepaalt wat DNSense ziet:

• User: de eigen zones.
• Reseller: de eigen zones plus die van de accounts die het beheert.
• Admin: alle zones op de server.

Log in op het niveau waarop DNSense moet werken.

De key aanmaken

1. Ga naar Login Keys. In de Evolution-skin staat het onder Advanced Features, in de Enhanced-skin onder User Level. Je kunt ook direct /CMD_LOGIN_KEYS op je paneel openen.

2. Klik op Create Key.

3. Vul het formulier in:
   • Key Name, alleen voor jezelf. Geen gebruikersnaam.
   • Key Value, het wachtwoord. Gebruik de willekeurig-knop voor een lang exemplaar en kopieer het. Het is zichtbaar bij het aanmaken.
   • Expires On, optioneel. Laat leeg voor een permanente koppeling.
   • Allow HTM, uit. Dat staat browserlogins toe, wat een API-key niet nodig heeft.
   • Commands, beperkt tot de lijst hieronder.
   • Allowed IPs, een per regel, als je het adres weet waarvandaan DNSense verbindt.
   • Current Password, je DirectAdmin-wachtwoord ter bevestiging.

4. Klik op Create. DirectAdmin toont de key één keer in een venster. Kopieer hem voordat je het sluit.

De screenshots tonen de Evolution-skin en komen uit de kennisbank van een hostingprovider.

Welke commando's toestaan

Sta CMD_API_SHOW_DOMAINS en CMD_API_DNS_CONTROL toe, en voeg toe wat het accountniveau vraagt:

• Reseller: ook CMD_API_SHOW_USERS.
• Admin: ook CMD_API_DNS_ADMIN.

Sta ALL_USER, CMD_LOGIN_KEYS en CMD_API_LOGIN_KEYS niet toe. Elk daarvan laat de key andere login keys wijzigen, waarmee de hele beperking vervalt.

Koppelen aan DNSense

Voeg een koppeling toe, kies DirectAdmin en vul in:

• Hostname van je paneel.
• Port, alleen als het niet 2222 is.
• Username van het account.
• Login key (een wachtwoord werkt ook, maar gebruik de key).

Als een aanroep wordt geweigerd

DirectAdmin schrijft geweigerde commando's naar /var/log/directadmin/security.log. Kijk daar eerst. Het noemt het commando dat de key miste.