Partager via

EXECUTE AS (Transact-SQL)

  • Article

Définit le contexte d'exécution d'une session.

Par défaut, une session commence lorsqu'un utilisateur se connecte et se termine lorsqu'il se déconnecte. Au cours d'une session, toutes les opérations sont soumises à des vérifications d'autorisations pour cet utilisateur. Lors de l'exécution d'une instruction EXECUTE AS, le contexte d'exécution de la session bascule vers le nom de connexion ou d'utilisateur spécifié. Suite au changement de contexte, les autorisations sont vérifiées par rapport aux jetons de sécurité de connexion et d'utilisateur relatifs à ce compte au lieu de la personne qui appelle l'instruction EXECUTE AS. L'identité du compte d'utilisateur ou de connexion est naturellement empruntée pour toute la durée de la session ou de l'exécution du module, ou le changement de contexte est explicitement annulé.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

{ EXEC | EXECUTE } AS <context_specification>
[;]

<context_specification>::=
{ LOGIN | USER } = 'name'
    [ WITH { NO REVERT | COOKIE INTO @varbinary_variable } ] 
| CALLER

Arguments

  • LOGIN
    Spécifie que le contexte d'exécution dont l'identité est empruntée est une connexion. L'étendue de l'emprunt d'identité est au niveau du serveur.

    [!REMARQUE]

    Cette option n'est pas disponible dans une base de données à relation contenant-contenu.

  • USER
    Spécifie que le contexte dont l'identité doit être empruntée est un utilisateur de la base de données active. L'étendue de l'emprunt d'identité est limitée à la base de données active. Le changement de contexte vers un utilisateur de base de données n'hérite pas des autorisations de cet utilisateur au niveau serveur.

    Important

    Tant que le changement de contexte en faveur d'un utilisateur de base de données est en vigueur, toute tentative d'accès à des ressources situées en dehors de la base de données causera l'échec de l'instruction. Cela inclut les instructions USE database, les requêtes distribuées et les requêtes qui font référence à une autre base de données utilisant trois ou quatre identificateurs de portions.

  • ' name '
    Nom d'utilisateur ou de connexion valide. name doit être membre du rôle serveur fixe sysadmin ou exister en tant que principal respectivement dans sys.database_principals ou sys.server_principals.

    name peut être spécifié sous forme de variable locale.

    Le paramètre name doit être un compte singleton ; il ne peut s'agir d'un groupe, d'un rôle, d'un certificat, d'une clé ni d'un compte intégré, tel que NT AUTHORITY\LocalService, NT AUTHORITY\NetworkService ou NT AUTHORITY\LocalSystem.

    Pour plus d'informations, consultez Spécification d'un nom d'utilisateur ou de connexion, plus loin dans cette rubrique.

  • NO REVERT
    Spécifie qu'il n'est pas possible de restaurer le changement de contexte pour revenir au contexte précédent. L'option NO REVERT ne peut être utilisée qu'au niveau approprié.

    Pour plus d'informations sur le retour au contexte précédent, consultez REVERT (Transact-SQL).

  • COOKIE INTO **@**varbinary_variable
    Spécifie que le contexte d'exécution ne peut être restauré vers le contexte précédent que si l'instruction REVERT WITH COOKIE appelante contient la valeur **@**varbinary_variable correcte. Le Moteur de base de données passe le cookie à **@**varbinary_variable. L'option COOKIE INTO ne peut être utilisée qu'au niveau approprié.

    **@**varbinary_variable est de type varbinary(8000).

    [!REMARQUE]

    Le paramètre OUTPUT de cookie est actuellement documenté comme varbinary(8000), ce qui correspond à la longueur maximale correcte. Toutefois, l'implémentation actuelle retourne varbinary(100). Les applications doivent réserver varbinary(8000) afin de continuer à fonctionner correctement si la taille de retour des cookies augmente dans une version ultérieure.

  • CALLER
    Dans un module, il spécifie que les instructions de ce module sont exécutées dans le contexte de l'appelant du module.

    En dehors d'un module, cette instruction n'a pas d'effet.

Notes

Le changement dans le contexte d'exécution reste en vigueur jusqu'à ce que se produise l'une des actions suivantes :

  • Une autre instruction EXECUTE AS s'exécute.

  • Une instruction REVERT s'exécute.

  • Suppression de la session.

  • La procédure stockée ou le déclencheur où la commande exécutée se termine.

Vous pouvez créer une pile de contextes d'exécution en appelant l'instruction EXECUTE AS plusieurs fois sur plusieurs principaux. Lorsqu'elle est appelée, l'instruction REVERT bascule le contexte vers la connexion ou l'utilisateur du niveau supérieur dans la pile de contexte. Vous en trouverez une démonstration dans Exemple A.

Spécification d'un nom d'utilisateur ou de connexion

Le nom d'utilisateur ou de connexion spécifié dans EXECUTE AS <context_specification> doit exister en tant que principal respectivement dans sys.database_principals ou sys.server_principals, sinon l'instruction EXECUTE AS échoue. De plus, les autorisations IMPERSONATE doivent être accordées sur le principal. Sauf si l'appelant est le propriétaire de la base de données, ou un membre du rôle serveur fixe sysadmin, le principal doit exister même lorsque l'utilisateur accède à la base de données ou l'instance de SQL Server du fait de son appartenance à un groupe Windows. Par exemple, supposons les conditions suivantes :

  • Le groupe CompanyDomain\SQLUsers a accès à la base de données Sales.

  • CompanyDomain\SqlUser1 est membre de SQLUsers et de ce fait bénéficie d'un accès implicite à la base de données Sales.

Bien que CompanyDomain\SqlUser1 ait accès à la base de données du fait de son appartenance au groupe SQLUsers, l'instruction EXECUTE AS USER = 'CompanyDomain\SqlUser1' échoue parce que CompanyDomain\SqlUser1 n'existe pas comme principal dans la base de données.

Si l'utilisateur est orphelin (la connexion associée n'existant plus) et qu'il n'a pas été créé au moyen de la clause WITHOUT LOGIN, l'instruction EXECUTE AS échoue pour l'utilisateur.

Conseil

Spécifiez une connexion ou un utilisateur bénéficiant du minimum de privilèges indispensable pour effectuer les opérations dans la session. Par exemple, ne spécifiez pas de nom de connexion avec des autorisations de niveau serveur, si seules les autorisations de niveau base de données sont requises ; ne spécifiez pas non plus un compte de propriétaire de base de données à moins que ces autorisations ne soient nécessaires.

AttentionAttention

L'instruction EXECUTE AS peut réussir tant que le Moteur de base de données peut résoudre le nom. Si un utilisateur de domaine existe, Windows peut être en mesure de résoudre l'utilisateur pour le Moteur de base de données, même si l'utilisateur windows n'a pas accès à SQL Server. Cela peut entraîner une condition selon laquelle une connexion sans accès à SQL Server semble être connectée, alors que la connexion avec emprunt d'identité dispose uniquement des autorisations accordées au public ou à l'invité.

Utilisation de WITH NO REVERT

Lorsque l'instruction EXECUTE AS comporte la clause WITH NO REVERT facultative, le contexte d'exécution d'une session ne peut pas être réinitialisé à l'aide de REVERT ou en exécutant une autre instruction EXECUTE AS. Le contexte défini par l'instruction reste en vigueur jusqu'à ce que la session soit supprimée.

Lorsque la clause WITH NO REVERT COOKIE = @varbinary\_variable est spécifiée, le Moteur de base de données SQL Server passe la valeur du cookie à @varbinary\_variable. Le contexte d'exécution défini par cette instruction ne peut être restauré vers le contexte précédent que si l'instruction REVERT WITH COOKIE = @varbinary\_variable appelante contient la même valeur @varbinary\_variable .

Cette option est utile dans un environnement où le groupement de connexions est utilisé. Le groupement de connexions est la maintenance d'un groupe de connexions de base de données à réutiliser par des applications sur un serveur d'applications. Comme la valeur passée à @varbinary\_variable n'est connue que de l'appelant de l'instruction EXECUTE AS, celui-ci peut garantir que le contexte d'exécution qu'il établit ne peut pas être modifié par une tierce personne.

Identification de la connexion originale

Utilisez la fonction ORIGINAL_LOGIN pour retourner le nom de la connexion utilisée pour se connecter à l'instance de SQL Server. Vous pouvez utiliser cette fonction pour retourner l'identité de la connexion originale dans les sessions dans lesquelles il y a beaucoup de changements de contexte explicites ou implicites.

Autorisations

Pour spécifier EXECUTE AS comme connexion, l'appelant doit avoir les autorisations IMPERSONATE sur le nom de connexion spécifié. Pour spécifier EXECUTE AS sur un utilisateur de base de données, l'appelant doit avoir les autorisations IMPERSONATE sur le nom d'utilisateur spécifié. Lorsque EXECUTE AS CALLER est spécifié, les autorisations IMPERSONATE ne sont pas nécessaires.

Exemples

A.Utilisation de EXECUTE AS et REVERT pour changer de contexte

L'exemple suivant crée une pile d'exécutions de contexte à l'aide de plusieurs principaux. L'instruction REVERT est ensuite utilisée pour réinitialiser le contexte d'exécution à l'appelant précédent. L'instruction REVERT est exécutée plusieurs fois en remontant la pile jusqu'à ce que le contexte d'exécution soit défini pour l'appelant d'origine.

USE AdventureWorks2012;
GO
--Create two temporary principals
CREATE LOGIN login1 WITH PASSWORD = 'J345#$)thb';
CREATE LOGIN login2 WITH PASSWORD = 'Uor80$23b';
GO
CREATE USER user1 FOR LOGIN login1;
CREATE USER user2 FOR LOGIN login2;
GO
--Give IMPERSONATE permissions on user2 to user1
--so that user1 can successfully set the execution context to user2.
GRANT IMPERSONATE ON USER:: user2 TO user1;
GO
--Display current execution context.
SELECT SUSER_NAME(), USER_NAME();
-- Set the execution context to login1. 
EXECUTE AS LOGIN = 'login1';
--Verify the execution context is now login1.
SELECT SUSER_NAME(), USER_NAME();
--Login1 sets the execution context to login2.
EXECUTE AS USER = 'user2';
--Display current execution context.
SELECT SUSER_NAME(), USER_NAME();
-- The execution context stack now has three principals: the originating caller, login1 and login2.
--The following REVERT statements will reset the execution context to the previous context.
REVERT;
--Display current execution context.
SELECT SUSER_NAME(), USER_NAME();
REVERT;
--Display current execution context.
SELECT SUSER_NAME(), USER_NAME();

--Remove temporary principals.
DROP LOGIN login1;
DROP LOGIN login2;
DROP USER user1;
DROP USER user2;
GO

L'exemple suivant définit le contexte d'exécution d'une session sur un utilisateur spécifié et précise la clause WITH NO REVERT COOKIE = @varbinary\_variable. L'instruction REVERT doit spécifier la valeur passée à la variable @cookie dans l'instruction EXECUTE AS pour ramener le contexte à l'appelant. Pour exécuter cet exemple, la connexion login1 et l'utilisateur user1 créés dans l'exemple A doivent exister.

DECLARE @cookie varbinary(8000);
EXECUTE AS USER = 'user1' WITH COOKIE INTO @cookie;
-- Store the cookie in a safe location in your application.
-- Verify the context switch.
SELECT SUSER_NAME(), USER_NAME();
--Display the cookie value.
SELECT @cookie;
GO
-- Use the cookie in the REVERT statement.
DECLARE @cookie varbinary(8000);
-- Set the cookie value to the one from the SELECT @cookie statement.
SET @cookie = <value from the SELECT @cookie statement>;
REVERT WITH COOKIE = @cookie;
-- Verify the context switch reverted.
SELECT SUSER_NAME(), USER_NAME();
GO

Voir aussi

Référence

REVERT (Transact-SQL)

Clause EXECUTE AS (Transact-SQL)