EXECUTE AS (Transact-SQL)

S’applique à : SQL Server base de données Azure SQL Azure SQL Managed Instance Azure Synapse Analytics

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. Quand une instruction EXECUTE AS est exécutée, le contexte d’exécution de la session change 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é.

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

Connexion
S’applique à : SQL Server 2008 (10.0.x) et versions ultérieures.

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.

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

'name' est un nom d'utilisateur ou de connexion valide. name doit être membre du rôle serveur fixe sysadmin, ou exister comme principal respectivement dans sys.database_principals ou sys.server_principals.

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

name doit être un compte singleton. Ce ne peut pas être un groupe, un rôle, un certificat, une clé ni 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 d’un ID 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 peut uniquement être utilisée au niveau adhoc.

Pour plus d’informations sur la restauration du contexte précédent, consultez REVERT (Transact-SQL).

COOKIE INTO @varbinary_variable
Spécifie que le contexte d’exécution peut être restauré vers le contexte précédent uniquement 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 peut uniquement être utilisée au niveau adhoc.

@varbinary_variable est varbinary(8000) .

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. Pour avoir une démonstration de ce comportement, consultez Exemple A.

Spécification d'un utilisateur ou d'un nom d'accès

Le nom d’utilisateur ou de connexion spécifié dans EXECUTE AS <context_specification> doit exister comme 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 quand l’utilisateur a accès à 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 bénéficie donc d’un accès implicite à la base de données Sales.

CompanyDomain\SqlUser1 a accès à la base de données du fait de son appartenance au groupe SQLUsers, mais 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éé avec la clause WITHOUT LOGIN, l’instruction EXECUTE AS échoue pour cet utilisateur.

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

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.

Quand la clause WITH NO REVERT COOKIE = @varbinary_variable est spécifiée, Moteur de base de données SQL Server passe la valeur de 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 sera pas modifié par un autre utilisateur.

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 renvoyer l'identité de la connexion d'origine dans les sessions où il y a un grand nombre de changements de contexte implicites ou explicites.

Autorisations

Pour spécifier EXECUTE AS sur une connexion, l’appelant doit avoir l’autorisation IMPERSONATE sur le nom de connexion spécifié et l’autorisation IMPERSONATE ANY LOGIN ne doit pas lui être refusée. 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é. Quand EXECUTE AS CALLER est spécifié, les autorisations IMPERSONATE ne sont pas nécessaires.

Exemples

R. 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 AdventureWorks2022;  
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  

B. Utilisation de la clause WITH COOKIE

L’exemple suivant définit le contexte d’exécution d’une session sur un utilisateur spécifié et précise la clause WITH COOKIE INTO @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

REVERT (Transact-SQL)
Clause EXECUTE AS (Transact-SQL)