Descriptores de protección

Una cadena de regla del descriptor de protección contiene una lista secuencial de uno o varios protectores. Debe haber al menos un protector. Si hay más de uno, los protectores deben estar separados en la cadena por AND o OR. Estos valores deben incluirse en mayúsculas. La sintaxis siguiente muestra el formato de cadena de un descriptor de protección.

Descriptor = [ Protector-or
              *( OR-separator Protector-or ) ]

    Protector-or = Protector-and
              *( AND-separator Protector-and )

    OR-separator = "OR"
    AND-separator = "AND"

    Protector-and = providerName EQUALS providerAttributes

    providerName = descr

    providerAttribute = string | hexstring

      ; The following characters are to be escaped when they appear
      ; in the value to be encoded: ESC, one of <escaped>, leading
      ; SHARP or SPACE, trailing SPACE, and NULL.
      string =   [ ( leadchar / pair ) [ *( stringchar / pair )
         ( trailchar / pair ) ] ]

      leadchar = LUTF1 / UTFMB
      LUTF1 = %x01-1F / %x21 / %x24-2A / %x2D-3A / %x3D / %x3F-5B / %x5D-7F

      trailchar  = TUTF1 / UTFMB
      TUTF1 = %x01-1F / %x21 / %x23-2A / %x2D-3A / %x3D / %x3F-5B / %x5D-7F

      stringchar = SUTF1 / UTFMB
      SUTF1 = %x01-21 / %x23-2A / %x2D-3A / %x3D / %x3F-5B / %x5D-7F

      pair = ESC ( ESC / special / hexpair )
      special = escaped / SPACE / SHARP / EQUALS
      escaped = DQUOTE / PLUS / COMMA / SEMI / LANGLE / RANGLE
      hexstring = SHARP 1*hexpair
      hexpair = HEX HEX

      descr   = leadkeychar *keychar
      leadkeychar = ALPHA
      keychar = ALPHA / DIGIT / HYPHEN
      number  = DIGIT / ( LDIGIT 1*DIGIT )

      ALPHA   = %x41-5A / %x61-7A   ; "A"-"Z" / "a"-"z"
      DIGIT   = %x30 / LDIGIT       ; "0"-"9"
      LDIGIT  = %x31-39             ; "1"-"9"
      HEX     = DIGIT / %x41-46 / %x61-66 ; "0"-"9" / "A"-"F" / "a"-"f"

      NULL    = %x00 ; null (0)
      SPACE   = %x20 ; space (" ")
      DQUOTE  = %x22 ; quote (""")
      SHARP   = %x23 ; octothorpe (or sharp sign) ("#")
      DOLLAR  = %x24 ; dollar sign ("$")
      SQUOTE  = %x27 ; single quote ("'")
      LPAREN  = %x28 ; left paren ("(")
      RPAREN  = %x29 ; right paren (")")
      PLUS    = %x2B ; plus sign ("+")
      COMMA   = %x2C ; comma (",")
      HYPHEN  = %x2D ; hyphen ("-")
      DOT     = %x2E ; period (".")
      SEMI    = %x3B ; semicolon (";")
      LANGLE  = %x3C ; left angle bracket ("<")
      EQUALS  = %x3D ; equals sign ("=")
      RANGLE  = %x3E ; right angle bracket (">")
      ESC     = %x5C ; backslash ("\")
      USCORE  = %x5F ; underscore ("_")
      LCURLY  = %x7B ; left curly brace "{"
      RCURLY  = %x7D ; right curly brace "}"

      ; Any UTF-8 [RFC3629] encoded Unicode [Unicode] character
      UTF8    = UTF1 / UTFMB
      UTFMB   = UTF2 / UTF3 / UTF4
      UTF0    = %x80-BF
      UTF1    = %x00-7F
      UTF2    = %xC2-DF UTF0
      UTF3    = %xE0 %xA0-BF UTF0 / %xE1-EC 2(UTF0) /
                %xED %x80-9F UTF0 / %xEE-EF 2(UTF0)
      UTF4    = %xF0 %x90-BF 2(UTF0) / %xF1-F3 3(UTF0) /
                %xF4 %x80-8F 2(UTF0)

      OCTET   = %x00-FF ; Any octet (8-bit data unit)

Actualmente, se pueden definir descriptores de protección para los siguientes tipos de autorización:

• Un grupo en un bosque de Active Directory.
• Conjunto de credenciales web.
• Un certificado en el almacén de certificados del usuario.

Entre los ejemplos de cadenas de regla de descriptores de protección para un grupo de Active Directory se incluyen los siguientes:

• "SID=S-1-5-21-4392301 AND SID=S-1-5-21-3101812"
• "SDDL=O:S-1-5-5-0-290724G:SYD:(A;; CCDC;;;; S-1-5-5-0-290724)(A;;D C;;; WD)"
• "LOCAL=user"
• "LOCAL=machine"

Entre los ejemplos de cadenas de reglas de descriptor de protección para un conjunto de credenciales web se incluyen los siguientes:

• "WEBCREDENTIALS=MyPasswordName"
• "WEBCREDENTIALS=MyPasswordName,myweb.com"

Entre los ejemplos de cadenas de reglas de descriptor de protección para un certificado se incluyen los siguientes:

• "CERTIFICATE=HashID:sha1_hash_of_certificate"
• "CERTIFICATE=CertBlob:base64String"

El descriptor de protección que especifique determina automáticamente qué proveedor de protección de claves se usa. Para obtener más información, consulte Proveedores de protección.

Tenga en cuenta que el lado izquierdo del signo igual (=) debe ser SID, SDDL, LOCAL, WEBCREDENTIALS o CERTIFICATE. Estos valores no distinguen entre mayúsculas y minúsculas.

Debe especificar una cadena de regla (o un nombre para mostrar asociado a una cadena de regla) al llamar a la función NCryptCreateProtectionDescriptor . Como alternativa, dado que las cadenas de reglas del descriptor de protección son algo complicadas de usar y recordar, puede asociar un nombre para mostrar a la cadena de regla y registrar ambas mediante la función NCryptRegisterProtectionDescriptorName . A continuación, puede usar el nombre para mostrar en NCryptCreateProtectionDescriptor.

Temas relacionados

CNG DPAPI

Proveedores de protección