DotNet Environment

The DotNet Environment is for service clients that use .NET strong name signing. A .NET strong name signing adds a unique identity to your .NET binaries.

Information can originate from a VCC environment template. You can set these values via POST Codesign/GetEnvironment.

  • DotNetEnvironment: has these values:

    • AllowUserKeyImport: Applies only to PerUser templates. The setting for key import: true: users can import their own signing keys. false: no key import.
    • Disabled: A value of true indicates the environment is in use. Otherwise, false.
    • Dn: The Distinguished Name (DN) of the environment.
    • Guid: The GUID that uniquely identifies the environment.
    • IPAddressRestriction: An Items array of trusted client IP addresses.
    • Id: The environment ID.
    • KeyTimeConstraints: An Items array of signing Time Constraints from VCC.
    • KeyUseFlowDN: The Distinguished Name (DN) location of the Code Signing Flow. In VCC, the flow shows required approvals, checks, and actions that enable key usage.
    • PerUser:  Only appears if the value is true. The mode that supports multiple cryptographic objects and macros to use for signing. This field determines how objects are created for the Environment.
    • TemplateDN: The location of the template.
    • DotNetTemplate: The values from a DotNet environment template.

    • Expiration: The expiration time from the template. The number of minutes until key expires. A value of zero 0 means the key will not expire. Info: Suggests or locks this value as mandatory. Value: When value originated from the template, the Dirty flag is true. Also includes an Items array of acceptable values.

    • KeyAlgorithm: Acceptable key algorithms for the certificate. See Environment details.

    • KeyDN:  the Distinguished Name (DN) location of the key container

    • KeyStorageLocation: The location of the private key. Software or HSM. See Environment details.

    • MaxUses: environment values for the maximum number of key pair uses. See Environment details.

  • Error: Appears only when Success is false. An error message that accompanies the Result. Check your payload input values.
  • Result: The Result code of this API call. For more information, see Sign Result Codes.
  • Success: The result of this API call: A value of false indicates the request failed due to an Error. Otherwise, true. 
{
   "DotNetEnvironment":{
      "AllowUserKeyImport":true,
      "CustomFieldAttributes":{
         "Items":[
            
         ]
      },
      "Disabled":true,
      "Dn":"\\VED\\Code Signing\\Projects\\Sample\\DOTNetEnv",
      "Guid":"{f01f02cb-50d3-4a1e-8cec-b3bae7fa2d75}",
      "IPAddressRestriction":{
         "Items":[
            
         ]
      },
      "Id":1530,
      "KeyTimeConstraints":{
         "Items":[
            
         ]
      },
      "PerUser":true,
      "TemplateDN":"\\VED\\Code Signing\\Environment Templates\\DotNet",
      "Type":"Code Signing DotNet Environment",
      "DotNetTemplate":{
         "AllowUserKeyImport":true,
         "Dirty":true,
         "Dn":"\\VED\\Code Signing\\Environment Templates\\DotNet",
         "Guid":"{a8ae2436-9ba6-4ec6-95a9-255e4c2879ac}",
         "Id":1523,
         "ObjectNamingPattern":"$Sign.Project$\\$Sign.Environment$\\$Sign.User$",
         "PerUser":true,
         "Type":"Code Signing DotNet Environment Template",
         "VisibleTo":{
            "Dirty":true,
            "Items":[
               
            ]
         },
         "Expiration":{
            "Info":1,
            "Value":{
               "Dirty":true,
               "Items":[
                  
               ]
            }
         },
         "KeyAlgorithm":{
            "Info":1,
            "Value":{
               "Dirty":true,
               "Items":[
                  
               ]
            }
         },
         "KeyStorageLocation":{
            "Info":1,
            "Value":{
               "Dirty":true,
               "Items":[
                  
               ]
            }
         },
         "MaxUses":{
            "Info":1,
            "Value":{
               "Dirty":true,
               "Items":[
                  
               ]
            }
         }
      },
      "Expiration":{
         "Info":1,
         "TemplateValues":null,
         "Value":null
      },
      "KeyAlgorithm":{
         "Info":1,
         "TemplateValues":null,
         "Value":null
      },
      "KeyDN":"\\VED\\Policy\\Code Signing\\Certificates\\Sample DOTNetEnv - Signing Key",
      "KeyStorageLocation":{
         "Info":1,
         "TemplateValues":null,
         "Value":null
      },
      "MaxUses":{
         "Info":1,
         "TemplateValues":null,
         "Value":null
      }
   }
}