Rozdział 3 · 3.5
Klucze logowania: logowanie dla skryptów i programów
Za pomocą Klucze logowania (w języku angielskim: login keys) tworzy Pan/Pani dodatkowe hasła do swojego konta DirectAdmin. Różnica w porównaniu ze zwykłym hasłem: klucz może automatycznie wygasać, może wykonywać tylko określone czynności i ewentualnie działać wyłącznie z określonych adresów IP. Oprócz tego można utworzyć link logowania, który pozwoli komuś zalogować się do Pana/Pani DirectAdmin bez hasła.
Do czego służy to?
- Skrypt lub program, który musi wykonać określoną czynność w Pana/Pani pakiecie przez API DirectAdmin, na przykład zaktualizować rekord DNS. Proszę nadać skryptowi klucz, który pozwala wyłącznie na tę jedną czynność, zamiast używać prawdziwego hasła.
- Tymczasowy dostęp dla osoby budującej Państwa stronę, z datą ważności, dzięki czemu dostęp automatycznie wygasa po zakończeniu zlecenia.
Wskazówka: Czy osoba budująca stronę potrzebuje dostępu wyłącznie do plików witryny? Proszę w takim razie utworzyć dla niej osobne konto FTP ograniczone do tego jednego katalogu (patrz FTP-accounts aanmaken en beheren). Jest to bezpieczniejsze i prostsze niż udzielanie dostępu do całego DirectAdmin.
Otwieranie Klucze logowania
- Proszę kliknąć w prawym górnym rogu na Witaj, a następnie na swoją nazwę użytkownika, i wybrać Klucze logowania. Znajdzie Pan/Pani tę opcję również w menu w sekcji Funkcje zaawansowane.
- Widoczne są dwie zakładki: Klucze logowania i URLe logowania (3). U góry znajdują się przyciski UTWÓRZ KLUCZ LOGOWANIA (1) i UTWÓRZ URL LOGOWANIA (2).

W tabeli dla każdego klucza widoczna jest jego nazwa, które polecenia są dozwolone i odrzucone, z jakich sieci działa, kiedy wygasa oraz kiedy i przez kogo został utworzony.
Tworzenie klucza
Potrzebne jest do tego Pana/Pani obecne hasło DA. Jeśli zawsze loguje się Pan/Pani przez Mój WebOké i nie zna go Pan/Pani? Proszę najpierw je ustawić (patrz Hasło DA ustawianie lub zmiana).
- Proszę kliknąć UTWÓRZ KLUCZ LOGOWANIA.
- W polu Nazwa klucza (1) proszę wpisać rozpoznawalną nazwę, wyłącznie litery i cyfry, na przykład webbouwer lub dnsscript. Jest to etykieta dla własnej orientacji, a nie nazwa użytkownika służąca do logowania.
- W polu Sleutel waarde (2) pojawia się sam klucz: dodatkowe hasło. Proszę użyć długiej, losowej wartości.
- W polu Wygasa w (3) proszę zaznaczyć Ma datę ważności i wybrać datę. Bez zaznaczenia tej opcji klucz nigdy nie wygaśnie. Opcja Wis Sleutel powoduje, że klucz zostanie automatycznie usunięty po wygaśnięciu.
- HTM toestaan (4): proszę zaznaczyć tę opcję, jeśli klucz ma pozwalać również na logowanie się do strony internetowej DirectAdmin. Bez zaznaczenia tej opcji klucz działa wyłącznie dla API, czyli dla skryptów.
- W polu Opdrachten (5) dla każdego polecenia wybiera Pan/Pani, czy jest ono dozwolone, czy odrzucone. Jeśli niczego Pan/Pani nie wybierze, wszystkie polecenia są dozwolone.

- Na dole w polu Toegestaan IP adressen (1) za pomocą Netwerk Toevoegen może Pan/Pani określić, z jakich adresów IP klucz będzie działał. Jeśli nic Pan/Pani nie doda, klucz będzie działał z każdego adresu IP.
- W polu Huidige Wachtwoord (2) proszę wpisać swoje hasło DA i kliknąć AANMAKEN (3).

Uwaga: Proszę od razu zapisać wartość klucza. Klucze są przechowywane w postaci zaszyfrowanej, podobnie jak hasła: później nie będzie można ich już odczytać. Jeśli Pan/Pani go zgubi, proszę usunąć klucz i utworzyć nowy.
Logowanie za pomocą klucza
Za pomocą klucza loguje się Pan/Pani przy użyciu swojej zwykłej nazwy użytkownika DA, a wartość klucza pełni rolę hasła. Skrypt używa tej samej kombinacji do API DirectAdmin (patrz Dokumentacja API w sekcji Wsparcie i pomoc).
Jakie polecenia należy wykluczyć?
Proszę nadawać kluczowi jak najmniej uprawnień, ile jest to konieczne. Dla skryptu proszę wybrać wyłącznie te polecenia, których naprawdę używa. Szczególną ostrożność należy zachować przy tych trzech:
- ALL_USER: wszystkie polecenia dostępne na Pana/Pani koncie, czyli tyle samo, co zwykłe hasło;
- CMD_LOGIN_KEYS i CMD_API_LOGIN_KEYS: dzięki nim klucz może sam tworzyć nowe klucze, z większymi uprawnieniami.
Proszę wykluczyć również CMD_PASSWD i CMD_API_PASSWD, aby klucz nie mógł zmienić Pana/Pani hasła.
Tworzenie linku logowania
Za pomocą UTWÓRZ URL LOGOWANIA tworzy Pan/Pani link, dzięki któremu ktoś zostanie bezpośrednio zalogowany do Pana/Pani DirectAdmin, bez hasła.

- Wygasa w (1): proszę wybrać krótki okres ważności, na przykład jeden dzień.
- Adres przekierowania (2): strona, na którą prowadzi link. Pozostawienie pola pustego oznacza panel główny.
- Toegestaan IP adressen (3): proszę ograniczyć link do adresu IP osoby, która ma go użyć.
- Proszę wpisać swoje Huidige Wachtwoord (4) i kliknąć AANMAKEN.
Przycisk DirectAdmin w Moim WebOké działa w ten sam sposób: za każdym razem tworzy jednorazowy link logowania, ważny przez 60 minut. Dlatego przy swoich sesjach widnieje wpis Klucz logowania, jeśli zalogował się Pan/Pani przez Mój WebOké (patrz Wylogowanie i bezpieczne zamknięcie sesji).
Usuwanie klucza
Proszę usunąć klucz, gdy tylko nie jest już potrzebny, na przykład gdy osoba budująca stronę zakończyła pracę. Można to zrobić w tabeli na stronie Klucze logowania, przy danym kluczu. Warto też od czasu do czasu sprawdzić, czy nie znajdują się tam klucze, których Pan/Pani nie rozpoznaje.
