EXECUTE AS (Transact-SQL)

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é. Pour plus d'informations sur les contextes d'exécution, consultez Présentation du contexte d'exécution. Pour plus d'informations sur les changements de contexte, consultez Description du basculement de contexte.

Icône Lien de rubriqueConventions de 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.

  • USER
    Spécifie que le contexte dont l'identité est 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. Pour prolonger l'étendue du changement de contexte en dehors de la base de données active, consultez Prolongement de l'emprunt d'identité au niveau de la base de données à l'aide de EXECUTE AS.

  • 'name'
    Utilisateur ou nom 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.

    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'argument @varbinary_variable est de type varbinary(100).

  • 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.

  • La session est supprimée.

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. À moins que l'appelant soit 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 à une instance de SQL Server par le biais d'une appartenance à un groupe Windows. Par exemple, supposons les conditions suivantes :

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

  • L'utilisateur CompanyDomain\SqlUser1 est membre de SQLUsers ; il a donc 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.

Meilleure pratique

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 aboutir dès l'instant où le Moteur de base de données est en mesure de résoudre le nom. S'il existe un utilisateur de domaine, 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 aboutir à une condition dans laquelle une connexion sans accès à SQL Server semble être établie, bien que le nom de connexion emprunté ne dispose que des autorisations accordées au public ou à un 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 transmet la valeur du cookie à @varbinary_variable. Le contexte d'exécution défini par cette instruction ne peut être restauré au 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 AdventureWorks2008R2;
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 REVERT WITH 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(100);
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(100);
-- 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