DTSSignatureStatus Enumeration
Describes the status of the digital signature.
Namespace: Microsoft.SqlServer.Dts.Runtime
Assembly: Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)
Syntax
'Declaration
Public Enumeration DTSSignatureStatus
'Usage
Dim instance As DTSSignatureStatus
public enum DTSSignatureStatus
public enum class DTSSignatureStatus
type DTSSignatureStatus
public enum DTSSignatureStatus
Members
| Member name | Description | |
|---|---|---|
| Invalid | The signature is not valid. | |
| NotPresent | The signature is not present. | |
| Good | The signature is valid. | |
| Untrusted | The signature is from an untrusted source. |
Remarks
A package can be signed with a digital signature. By using a digital signature, you can help ensure that only packages from trusted sources are opened and run. However, to ensure that Integration Services checks the digital signature when it loads a package, you must also do at least one of the following steps:
Set the value of a registry entry.
Set a command prompt option for the dtexec utility (dtexec.exe).
Set a property in BI Development Studio.
Set a property in your code when you load or run packages programmatically. For example, the CheckSignatureOnLoad property of the Application class determines whether the signature is checked.
For more information, see Using Digital Signatures with Packages.
Important
When configured to check the signature of the package, Integration Services only checks whether the digital signature is present, is valid, and is from a trusted source. Integration Services does not check whether the package has been changed.
Examples
The following code example specifies through the Application class that the package will have its signature checked on load.
Application app = new Application();
app.CheckSignatureOnLoad = CheckSignatureOnLoad;
pkg = app.LoadPackage(mysavedPackagePath, null);
DTSSignatureStatus expectedStatus = DTSSignatureStatus.Good;
DTSSignatureStatus dss = pkg.CheckSignature();
if (dss != expectedStatus)
{
Console.WriteLine("Status not valid: found " + dss + ", expected " + expectedStatus);
}
Dim app As Application = New Application()
app.CheckSignatureOnLoad = CheckSignatureOnLoad
pkg = app.LoadPackage(mysavedPackagePath, Nothing)
Dim expectedStatus As DTSSignatureStatus = DTSSignatureStatus.Good
Dim dss As DTSSignatureStatus = pkg.CheckSignature()
If dss <> expectedStatus Then
Console.WriteLine("Status not valid: found " + dss + ", expected " + expectedStatus)
End If