https://github.com/libdns/directadmin

https://github.com/libdns/directadmin

Last synced: 4 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/libdns/directadmin
• Owner: libdns
• License: mit
• Created: 2023-05-03T15:10:06.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2025-09-25T19:50:57.000Z (9 months ago)
• Last Synced: 2025-10-10T14:21:11.152Z (8 months ago)
• Language: Go
• Size: 131 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
DirectAdmin for [`libdns`](https://github.com/libdns/libdns)

=======================

[![Go Reference](https://pkg.go.dev/badge/test.svg)](https://pkg.go.dev/github.com/libdns/directadmin)

This package implements the [libdns interfaces](https://github.com/libdns/libdns) for DirectAdmin, allowing you to manage DNS records.

## Authenticating

This package supports API **[Login Keys](https://docs.directadmin.com/directadmin/customizing-workflow/api-all-about.html#creating-a-login-key)** for authentication.

To create a key select `Login Keys` from the top right dropdown menu:

![Screenshot of login keys dropdown](./assets/admin-dropdown.png)

From the `Login Keys` page select `Create Key`

![Screenshot of login keys page with create key button](./assets/login-key-create-button.png)

You will need to create a login key with the following settings:

- **Key Name**

  - Select Descriptive Name

- **Expires On**

  - You can set this to whatever you need, but "Never" is likely the best option

- **Clear Key**

  - Unchecked

- **Allow HTM**

  - Unchecked

- **Commands To Allow**

  - `CMD_API_SHOW_DOMAINS`

  - `CMD_API_DNS_CONTROL`

The `CMD_API_SHOW_DOMAINS` permission is needed to get the zone ID, the `CMD_API_DNS_CONTROL` permission is obviously necessary to edit the DNS records.

If you're only using the `GetRecords()` method, you can remove the `CMD_API_DNS_CONTROL` permission to guarantee no changes will be made.

![Screenshot of login key settings](./assets/login-key-options.png)