A adutil – Active Directory segédprogram bemutatása

A következőkre vonatkozik:SQL Server Linux rendszeren

A adutil eszköz parancssori felületi (CLI) segédprogram, a SQL Server on Linux és tárolók Windows Active Directory tartományainak konfigurálásához és kezeléséhez. Ez szükségtelenné teszi a Windows és a Linux gépek közötti váltást a Active Directory kezeléséhez.

Note

A adutil támogatása csak SQL Server használati esetekre korlátozódik. A ktpass segédprogramot is használhatja az Active Directory hitelesítés engedélyezéséhez, ahogyan az a Tutorial: Use Active Directory authentication with SQL Server on Linux útmutatóban található.

Első lépésként töltse le adutil egy olyan gazdagépre, amely már csatlakozott egy Active Directory tartományhoz.

Az adutil eszköz parancsok és alparancsok sorozataként lett kialakítva, további bemenetként megadott további jelzőkkel. Minden felső szintű parancs a felügyeleti függvények kategóriáját jelöli. Ebben a kategóriában minden alparancs egy művelet. Ez a cikk bemutatja, hogyan töltheti le és kezdheti el az első lépéseket adutil.

LDAP konfigurálása adutil SSL (Biztonságos csatorna réteg) keresztül

Az Lightweight Directory Access Protocolt SSL-en (LDAPS) keresztül kell használnia a Lightweight Directory Access Protocol (LDAP) helyett. Az LDAP-ról további információt az Lightweight Directory Access Protocol (LDAP) című témakörben talál.

A(z) useLdaps beállítást true a adutil.json konfigurációs fájlban állíthatja be. Amikor a adutil felhasználó alatt futmssql, a konfigurációs fájl a következő helyen /var/opt/mssql/.adutil/adutil.jsontalálható: . Ez a JSON-kódminta a beállítás konfigurálását mutatja be:

{
    "useLdaps": "true"
}

Alapértelmezés szerint useLdaps az false. Ha ezt a beállítást konfigurálja, és mssql-conf használja a kulcstábla létrehozására, győződjön meg arról, hogy mssql-conf-ként, a mssql felhasználóként futtatja. Futtassa a következő parancsot a mssql felhasználóra való váltáshoz:

sudo su mssql

A keytab mssql-conf használatával történő beállításához lásd: A SQL Server szolgáltatáskulcsfájl létrehozása mssql-conf használatával.

adutil telepítése

Ha a telepítés során nem fogadja el a végfelhasználói licencszerződést (EULA), a parancs első futtatásakor adutil a --accept-eula jelölővel kell futtatnia (az összes disztribúció esetében).

  1. Töltse le a Microsoft Red Hat-adattár konfigurációs fájlját.

    RHEL 10

    sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/10/prod.repo
    

    RHEL 9

    sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/9/prod.repo
    

    RHEL 8

    sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/8/prod.repo
    
  2. Ha a korábbi előzetes verziót telepítette adutil, távolítsa el a régebbi adutil csomagokat az alábbi paranccsal.

    sudo yum remove adutil-preview
    
  3. A telepítéshez adutilfuttassa a következő parancsot. ACCEPT_EULA=Y elfogadja az EULA-t a következőhöz adutil: . Az EULA a következő helyen /usr/share/adutil/található: .

    sudo ACCEPT_EULA=Y yum install -y adutil
    

adutil használata Windows Active Directory kezeléséhez

Győződjön meg arról, hogy a adutil fájlt egy olyan gazdagépre tölti le, amely már csatlakozott egy Active Directory-tartományhoz. A Kerberos TGT -t (jegykiadó jegyet) is be kell szereznie vagy meg kell újítania a kinit paranccsal és egy emelt szintű tartományi fiókkal. A fiók, amelyet használ, rendelkeznie kell engedéllyel a tartományban fiókok és Szolgáltatásnév alapú névjegyek (SPN-ek) létrehozásához.

Íme néhány példa az adutilhasználatával végrehajtható műveletekre. A legfelső szintű parancsok listájának megtekintéséhez írja be a adutil --help. Ez a parancs azokat a legfelső szintű parancsokat mutatja be, amelyekkel kezelheti és együttműködhet az Active Directoryval.

adutil --help

A következő kimenet jelenik meg:

adutil - A general AD utility
  Usage:
    adutil [account|delegation|group|keytab|machine|ou|spn|user|config]
  Subcommands:
    account      Functions for generic account operations
    delegation   Functions for configuring delegation permissions
    group        Functions for group management
    keytab       Functions for keytab management
    machine      Functions for managing machine accounts
    ou           Functions for managing organizational units
    spn          Functions for service principal name (SPN) management
    user         Functions for user account management
    config       Functions for modifying adutil configuration
  Flags:
       --version       Displays the program version string.
    -h --help          Displays help with available flag, subcommand, and positional value parameters.
    -d --debug         Display additional debugging information when making LDAP/Kerberos calls.
       --accept-eula   Accepts the current EULA for adutil. This has no effect if the EULA has already been accepted.

Ha segítségre van szüksége az alacsonyabb szintű parancsokkal kapcsolatban, használja az alábbi példákat:

  • spn Parancs:

    adutil spn --help
    
  • spn search Parancs:

    adutil spn search --help
    

Samples

Minden parancs dokumentálva van, így azonnal megkezdheti az első lépéseket. Íme néhány olyan jellemző tevékenység, amelyet adutil használnak Active Directory hitelesítés konfigurálásakor vagy felügyeletekor SQL Server on Linux és tárolók esetében:

  • Fiók létrehozása az Active Directoryban:

    adutil user create --name sqluser --distname CN=sqluser,CN=Users,DC=CONTOSO,DC=COM
    
  • Fiókhoz vagy szolgáltatáshoz társított SPN-ek hozzáadása:

    adutil spn addauto -n sqluser -s MSSQLSvc -H mymachine.contoso.com -p 1433
    
  • Kulcsfájlok létrehozása a(z) adutil használatával.

    adutil keytab createauto -k /var/opt/mssql/secrets/mssql.keytab -p 1433 -H mymachine.contoso.com --password '<password>' -s MSSQLSvc
    

    Caution

    A jelszónak az SQL Server alapértelmezett password szabályzatot kell követnie. Alapértelmezés szerint a jelszónak legalább nyolc karakter hosszúnak kell lennie, és a következő négy készletből három karakterből kell állnia: nagybetűk, kisbetűk, 10 számjegyből és szimbólumokból. A jelszavak legfeljebb 128 karakter hosszúak lehetnek. Használjon olyan jelszavakat, amelyek a lehető legkomplexebbek és hosszúak.

További információkért tekintse meg a adutil referenciaoldalt a man adutil használatával.