Klucze API do DirectAdmin

Klucz API pozwala automatyzować konto hostingowe przez API DirectAdmin — np. skrypt wdrożeniowy, kopię zapasową albo monitoring — bez podawania hasła do konta. Tworzysz go w panelu klienta, a nie w DirectAdminie.

Co zyskasz#

• Wygenerujesz nazwany klucz API do konta DirectAdmin.
• Ustawisz jego ważność i adresy IP, z których zadziała.
• Użyjesz go w skrypcie i odwołasz, gdy przestanie być potrzebny.

Wymagania wstępne#

• Aktywna usługa hostingowa.
• Jesteś właścicielem konta klienta — osoby z Twojego zespołu kluczy nie tworzą.

Wskazówka

Klucz API nie loguje do panelu DirectAdmin w przeglądarce — działa wyłącznie przez API. Do panelu DirectAdmin wchodzisz przyciskiem Otwórz panel na stronie usługi. Webmasterowi, który ma poprawić pliki, daj konto FTP z dostępem do jednego katalogu — patrz Dodanie konta FTP.

Krok 1: Otwórz zakładkę Zaawansowane

Panel klienta → Usługi → wybierz usługę → zakładka Zaawansowane, sekcja Klucze API DirectAdmin.

Krok 2: Wygeneruj klucz

Kliknij Wygeneruj klucz i wypełnij:

• Nazwa — żeby rozpoznać klucz na liście (np. deploy-github, backup-nas),
• Wygaśnięcie — 1 rok (zalecane), 2 lata, własna liczba dni albo bez wygaśnięcia (ryzykowne),
• Opcje zaawansowane → lista adresów IP — klucz zadziała tylko z nich (po jednym w linii); mocno podnosi bezpieczeństwo,
• potwierdź, że traktujesz klucz jak hasło — daje dostęp do plików, baz i poczty konta.

Kliknij Wygeneruj klucz. Na jedno konto możesz mieć do 10 kluczy. O każdym utworzeniu wysyłamy e-mail z potwierdzeniem.

Krok 3: Skopiuj klucz — pokażemy go tylko raz

Po wygenerowaniu zobaczysz klucz i dane połączenia: adres API (https://hostXXXX.iqhs.pl:2222) i użytkownika (login konta, np. host36592). Skopiuj klucz od razu — nie przechowujemy go i nie pokażemy ponownie. Jeśli go zgubisz, usuń klucz i wygeneruj nowy.

Jak używać klucza#

API DirectAdmin przyjmuje uwierzytelnianie basic auth: użytkownik = login konta, hasło = klucz. Przykład — lista domen konta:

curl -u 'host36592:TWOJ_KLUCZ' \
  'https://host36592.iqhs.pl:2222/CMD_API_SHOW_DOMAINS'

Dostępne polecenia opisuje oficjalna dokumentacja API DirectAdmin. Klucz działa z uprawnieniami Twojego konta.

Usuwanie klucza#

Na liście w zakładce Zaawansowane kliknij Usuń przy kluczu — przestaje działać od razu. Usuń klucz, gdy:

• zakończyła się współpraca z osobą albo firmą, która go używała,
• podejrzewasz, że wyciekł (np. trafił do publicznego repozytorium),
• zbliża się jego wygaśnięcie i wymieniasz go na nowy.

Najczęstsze problemy#

1. „Nie widzę zakładki Zaawansowane”#

Zakładka jest tylko przy aktywnej usłudze hostingowej. Klucze tworzy wyłącznie właściciel konta — jeśli jesteś w panelu jako członek zespołu, zakładki z kluczami nie zobaczysz.

2. „Zapytanie zwraca błąd uwierzytelnienia”#

• Sprawdź, czy użytkownik to login konta (host36592), a nie e-mail.
• Klucz mógł wygasnąć albo zostać usunięty — sprawdź listę w zakładce.
• Jeśli ustawiłeś listę IP, zapytanie musi wyjść z jednego z tych adresów.

3. „Chcę się zalogować kluczem do panelu DirectAdmin”#

Nie da się — klucze z panelu klienta działają tylko przez API. Do panelu wejdziesz przyciskiem Otwórz panel na stronie usługi.

4. „Czy support potrzebuje mojego klucza?”#

Nie. Support ma dostęp administracyjny do serwerów — nie podawaj nikomu kluczy ani haseł w zgłoszeniu.

Słowniczek#

• API DirectAdmin — interfejs do sterowania kontem hostingowym z programów i skryptów.
• Basic auth — sposób logowania w API: użytkownik i hasło (tu: klucz) w nagłówku zapytania.
• Lista IP (whitelist) — adresy, z których klucz zadziała; z innych zostanie odrzucony.

Related

• Przejście z panelu klienta do DirectAdmin
• Dodanie konta FTP
• Klucze SSH i dostęp SSH
• 2FA w DirectAdmin