REVOKE – révocation d'autorisations de clé symétrique (Transact-SQL)

Article
10/16/2024

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Permet de révoquer des autorisations accordées ou refusées sur une clé symétrique.

Syntaxe

REVOKE [ GRANT OPTION FOR ] permission [ ,...n ]    
    ON SYMMETRIC KEY :: symmetric_key_name   
        { TO | FROM } <database_principal> [ ,...n ]   
    [ CASCADE ]  
    [ AS <database_principal> ]  
  
<database_principal> ::=   
        Database_user   
    | Database_role   
    | Application_role   
    | Database_user_mapped_to_Windows_User   
    | Database_user_mapped_to_Windows_Group   
    | Database_user_mapped_to_certificate   
    | Database_user_mapped_to_asymmetric_key   
    | Database_user_with_no_login

Arguments

permission
Spécifie une autorisation qui peut être révoquée sur une clé symétrique. Pour obtenir la liste des autorisations, consultez la section Notes plus loin dans cette rubrique.

ON SYMMETRIC KEY :: asymmetric_key_name
Spécifie la clé symétrique sur laquelle l'autorisation doit être révoquée. L'identificateur d'étendue (::) est requis.

GRANT OPTION
Indique que le droit d'accorder l'autorisation spécifiée à d'autres principaux sera révoqué. L'autorisation elle-même ne sera pas révoquée.

Important

Si le principal possède l'autorisation spécifiée sans l'option GRANT, l'autorisation elle-même sera révoquée.

CASCADE
Indique que l'autorisation en cours de révocation est également révoquée sur les principaux auxquels cette autorisation a été accordée ou révoquée par ce principal.

Attention

Une révocation en cascade d'une autorisation accordée avec l'option WITH GRANT OPTION entraîne la révocation des deux options GRANT et DENY de cette autorisation.

{ TO | FROM } <database_principal>
Spécifie le principal pour lequel l'autorisation est révoquée.

AS <database_principal> Spécifie un principal duquel le principal qui exécute cette requête dérive son droit de révoquer l’autorisation.

Database_user
Spécifie un utilisateur de base de données.

Database_role
Spécifie un rôle de base de données.

Application_role
Spécifie un rôle d'application.

Database_user_mapped_to_Windows_User
Spécifie un utilisateur de base de données mappé sur un utilisateur Windows.

Database_user_mapped_to_Windows_Group
Spécifie un utilisateur de base de données mappé à un groupe Windows.

Database_user_mapped_to_certificate
Spécifie un utilisateur de base de données mappé sur un certificat.

Database_user_mapped_to_asymmetric_key
Spécifie un utilisateur de base de données mappé à une clé asymétrique.

Database_user_with_no_login
Spécifie un utilisateur de base de données sans principal au niveau serveur correspondant.

Notes

Des informations sur les clés symétriques sont consultables dans la vue de catalogue sys.symmetric_keys.

L'instruction échoue si l'option CASCADE n'est pas spécifiée lors de la révocation d'une autorisation à partir d'un principal auquel cette autorisation a été accordée avec l'option GRANT OPTION.

Une clé symétrique est un élément sécurisable au niveau base de données inclus dans la base de données qui est son parent dans la hiérarchie des autorisations. Les autorisations les plus spécifiques et limitées qu'il est possible d'accorder sur une clé symétrique sont répertoriées dans le tableau ci-dessous, avec les autorisations plus générales qui les incluent de manière implicite.

Autorisation de clé symétrique	Déduite d'une autorisation de clé symétrique	Impliquée par une autorisation de base de données
ALTER	CONTROL	ALTER ANY SYMMETRIC KEY
CONTROL	CONTROL	CONTROL
REFERENCES	CONTROL	REFERENCES
TAKE OWNERSHIP	CONTROL	CONTROL
VIEW DEFINITION	CONTROL	VIEW DEFINITION

Autorisations

Requiert l'autorisation CONTROL sur la clé symétrique ou l'autorisation ALTER ANY SYMMETRIC KEY sur la base de données. Si vous utilisez l'option AS, le principal spécifié doit posséder la clé symétrique.

Exemples

Dans l'exemple ci-dessous, l'autorisation ALTER sur la clé symétrique SamInventory42 est révoquée pour l'utilisateur HamidS et pour d'autres principaux auxquels HamidS a accordé l'autorisation ALTER.

USE AdventureWorks2022;  
REVOKE ALTER ON SYMMETRIC KEY::SamInventory42 TO HamidS CASCADE;  
GO

Voir aussi

sys.symmetric_keys (Transact-SQL)
GRANT – octroi d'autorisations de clé symétrique (Transact-SQL)
DENY – refus d'autorisations de clé symétrique (Transact-SQL)
CREATE SYMMETRIC KEY (Transact-SQL)
Autorisations (moteur de base de données)
Principaux (moteur de base de données)
Hiérarchie de chiffrement

Partage via