A DirectAdmin API használata: a csomag kezelése szkriptekkel

A DirectAdminnak van egy API-ja: egy módja annak, hogy a csomagját szkripttel vagy programmal kezelje, nem pedig egérrel. Szinte minden, amit a vezérlőpultban tesz, elvégezhető az API-n keresztül is. Gondoljon például egy DNS-rekord frissítésére, ha otthon megváltozik az IP-címe, postafiókok létrehozására a saját szoftveréből, vagy akár arra, hogy minden éjjel lekérdezi az adatbázisai listáját.

Használhatom az API-t a csomagommal?

Igen. Az API minden olyan csomaggal működik, amelyhez DirectAdmin tartozik: az összes webtárhely-csomaggal, valamint az e-mail csomagokkal is. A viszonteladók emellett ezzel kezelhetik a saját ügyfeleik fiókjait is. Nem kell semmit igényelnie, és nem kerül extra költségbe.

Egy szkript pontosan ugyanazokkal a jogosultságokkal rendelkezik, mint Ön a DirectAdminban. Így csak a saját csomagjához fér hozzá, és csak azokat a dolgokat teheti meg, amelyeket a csomagja engedélyez.

Hogyan működik

• Cím: az API-val ugyanazon a helyen kommunikál, ahol bejelentkezik: https://szervernev:2222. A szervernevét a Fiókom felületen, a csomagnál, a Kezelés alatt találja.
• Kétféle parancs: az új API, amelynek címei /api/ kezdetűek, és a válaszok JSON formátumúak, valamint a régebbi API, amelynek parancsai /CMD_API_... formátumúak. Kezdje az új API-val. Amit ott még nem talál meg, azt a régi API-ban találja. Ehhez írja a végére, hogy ?json=yes, hogy JSON formátumú választ kapjon.
• Bejelentkezés: minden parancs elküldi a DA-felhasználónevét és egy jelszót (HTTP Basic hitelesítés). Ehhez lehetőleg bejelentkezési kulcsot (login key) használjon, ne a valódi DA-jelszavát, lásd lentebb.
• Dokumentáció a saját vezérlőpultjában: a DirectAdminban a Támogatás és segítség menüpont alatt találja az API dokumentációt. Ott megtekintheti az új API összes parancsát, és azonnal kipróbálhatja őket a saját fiókjával.

Egy példa

Ezzel a paranccsal lekérdezheti a csomagja adatbázisait. Cserélje ki a felhasznalo, kulcs és szervernev szavakat a saját adataira:

curl -u 'felhasznalo:kulcs' https://szervernev:2222/api/db-show/databases

Válaszul egy JSON formátumú listát kap. Ugyanígy működik PHP-ból, Pythonból vagy bármely más nyelvből, amely képes weboldalt lekérni.

Biztonságos munka bejelentkezési kulccsal

Soha ne adja meg egy szkriptnek a szokásos DA-jelszavát. Hozzon létre a DirectAdminban, a Bejelentkezési Kulcs menüpontnál, egy külön kulcsot. Egy ilyen kulcsot korlátozhat:

• csak azokra a parancsokra, amelyekre a szkriptnek valóban szüksége van;
• csak annak a számítógépnek vagy szervernek az IP-címéről, amelyen a szkript fut;
• lejárati dátummal, ha a hozzáférésre csak rövid ideig van szüksége.

Mindenképpen zárja ki a CMD_LOGIN_KEYS és a CMD_PASSWD parancsokat, hogy a kulcs ne tudjon új kulcsokat létrehozni, és ne tudja megváltoztatni a jelszavát. Ha a kulcs mégis kiszivárog, törölje azt, és hozzon létre egy újat, anélkül hogy a jelszavát meg kellene változtatnia.

Hogy hogyan hozhat létre egy kulcsot, azt lépésről lépésre megtalálja a DirectAdmin kézikönyvben: Bejelentkezési Kulcs: bejelentkezés szkriptek és programok számára.

Jó tudni

• Ha egy szkript gyakran próbál meg helytelen jelszóval vagy kulccsal bejelentkezni, a tűzfalunk blokkolja az adott IP-címet. Nézze meg a Le vagyok tiltva? oldalt, ha a szkriptje hirtelen nem tud többé kapcsolódni.
• Szívesen segítünk, ha maga az API nem működik, de saját szkripteket nem írunk és nem ellenőrzünk. Ehhez használja az alábbi DirectAdmin dokumentációt.
• Szívesebben kezelné a tárhelyét Claude, ChatGPT vagy Mistral segítségével, anélkül hogy programoznia kellene? Akkor nézze meg az MCP-szerverünket AI-hoz.

A DirectAdmin dokumentációja

A DirectAdmin dokumentációja angol nyelvű:

• API Access: hogyan működik az API, a bejelentkezés és az API különböző típusai.
• Examples: példák curl, Bash, PHP és Python használatával.
• Legacy API: a régebbi CMD_API parancsok és azok válaszai.
• Áttekintés a CMD_API parancsokról: keresés az összes régebbi parancs között.
• Creating a login key: bejelentkezési kulcsok a DirectAdmin szerint.

Lásd még a DirectAdmin kézikönyvben: A szervernév és a DA-felhasználónév megtalálása.