Identity Governance & Administration
sara.next
  1. sara.next
  2. Technologia
  3. Skrypty SQL: wartości zwracane i przykład

Technologia · Dokumentacja

Skrypty SQL: wartości zwracane i przykład

Skrypt Groovy nie wykonuje zapytań sam — zwraca instrukcje SQL, które sara.next uruchamia na skonfigurowanym połączeniu. Poniżej zasady i przykład dla Microsoft SQL Server.

  • Groovy
  • SQL
  • Microsoft SQL Server
  • przykład

Zasady

Co zwraca skrypt

Co zwraca skrypt
SkryptWartość zwracanaJak jest wykonywana
Implementacyjny (Create, Replace, Modify, Delete)String — pojedyncza instrukcja SQLInstrukcja jest wykonywana na połączeniu SQL aplikacji.
Implementacyjny — wiele instrukcjiList<String> — lista instrukcji SQLWszystkie instrukcje są wykonywane w jednej transakcji; przy błędzie następuje wycofanie.
WeryfikującyString z zapytaniem SELECTtrue, jeśli zapytanie zwróci co najmniej jeden wiersz; false, jeśli nie zwróci żadnego.

Przykład

Pełny przykład: Microsoft SQL Server

Przykład zakłada rolę z dwoma wymiarami: DB_NAME (nazwa bazy) i DB_OPERATIONS (lista ról bazodanowych lub uprawnień rozdzielona przecinkami). Gdy wymiar nie ma wartości, skrypt przyjmuje wartości domyślne demo i db_datareader.

Skrypt Create

Skrypt tworzy login serwera, jeśli jeszcze nie istnieje, następnie użytkownika w bazie, a na końcu nadaje uprawnienia: wartości zaczynające się od db_ są traktowane jako role bazodanowe (ALTER ROLE … ADD MEMBER), pozostałe jako uprawnienia (GRANT).

String login = user.samAccountName
String dbName = dimensions["DB_NAME"] ?: "demo"
String operations = dimensions["DB_OPERATIONS"] ?: "db_datareader"

List<String> sqls = []

sqls << "IF NOT EXISTS (SELECT 1 FROM sys.server_principals WHERE name = '${login}') " +
        "CREATE LOGIN [${login}] WITH PASSWORD = '<hasło tymczasowe>', " +
        "CHECK_POLICY = ON, CHECK_EXPIRATION = OFF;"

sqls << "USE [${dbName}]; " +
        "IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = '${login}') " +
        " CREATE USER [${login}] FOR LOGIN [${login}];"

operations.split(",").each { op ->
    String o = op.trim()
    if (o.startsWith("db_")) {
        sqls << "USE [${dbName}]; ALTER ROLE [${o}] ADD MEMBER [${login}];"
    } else {
        sqls << "USE [${dbName}]; GRANT ${o} TO [${login}];"
    }
}

return sqls*.toString()

WskazówkaW tym miejscu hasło tymczasowe zastąpiono symbolem <hasło tymczasowe>. Sposób nadawania hasła ustal zgodnie z polityką haseł swojej organizacji.

Skrypt Modify

Skrypt odczytuje poprzednie wartości wymiarów z request.oldAtar, a następnie:

  1. odbiera dotychczasowe role i uprawnienia w poprzedniej bazie,
  2. upewnia się, że użytkownik istnieje w nowej bazie,
  3. nadaje nowe role i uprawnienia.

Login poprzedniego użytkownika jest pobierany z bezpieczną nawigacją (oldUser?.samAccountName), a gdy go brak — przyjmowany jest login bieżącego użytkownika.

Skrypt Delete

Skrypt pobiera login z oldUser, a wartości wymiarów z request.oldAtar. Kolejno:

  1. odbiera role i uprawnienia w bazie,
  2. usuwa użytkownika bazy, jeśli nie ma on już członkostwa w żadnej roli,
  3. usuwa login serwera, jeśli nie ma on już użytkowników w żadnej z baz.

Skrypt Verify

Zapytanie sprawdza, czy użytkownik o loginie ze zmiennej login istnieje w bazie. Dla wniosku Delete wynik jest odwracany przez harmonogram.

String dbName = dimensions["DB_NAME"] ?: "demo"
return "SELECT 1 FROM [${dbName}].sys.database_principals WHERE name = '${login}'".toString()

UwagaNie należy kopiować przykładowych interpolacji tekstowych do kodu produkcyjnego bez walidacji. Identyfikatory użytkowników, role i nazwy baz powinny pochodzić z dopuszczonych list wartości, a zapytania muszą być projektowane z uwzględnieniem ryzyka SQL injection i praw systemowych konta integracyjnego.

Przygotuj skrypty SQL z naszym zespołem

Dobierzemy zakres uprawnień konta integracyjnego i sprawdzimy skrypty na środowisku testowym.