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

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

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

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 entités de sécurité sera révoqué. L'autorisation elle-même ne sera pas révoquée.

    Important

    Si l'entité de sécurité 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 à révoquer est également révoquée pour les autres entités de sécurité auxquelles elle a été accordée ou refusée par cette entité de sécurité.

    AttentionAttention

    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 l'entité de sécurité pour laquelle l'autorisation doit être révoquée.

  • AS <entité_de_sécurité_de_base_de_données>
    Spécifie une entité de sécurité à partir de laquelle l'entité de sécurité 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é sur 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é sur une clé asymétrique.

  • Database_user_with_no_login
    Spécifie un utilisateur de base de données sans entité de sécurité au niveau serveur correspondant.

Notes

Des informations sur les clés symétriques sont consultables dans l'affichage 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'une entité de sécurité à laquelle cette autorisation a été accordée avec l'option GRANT OPTION.

Une clé symétrique est un 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

Déduite d'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, l'entité de sécurité spécifiée 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 entités de sécurité auxquelles HamidS a accordé l'autorisation ALTER.

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