BizCrypto for BizTalk server includes a number of pipeline components. The following pipelines are supplied:
- PDF protection and unprotection pipelines
- OpenPGP protection and unprotection pipelines
- Pipelines providing S/MIME capabilities
- Asymmetric PKI (CMS) pipelines
- XML signing and validating pipelines
BizTalk server provides you with the ability to create complex pipelines by creating a stack of primitive pipelines. The message received from the network goes through the first pipeline, then the result of decoding is passed to the second pipeline and so on, until all the pipelines in the stack are processed. Each BizCrypto pipeline is a primitive building block that can be used as a part of complex pipeline chain.
To create the pipeline stack to be used in your BizTalk application, you should perform the following steps (the steps below describe the creation of receive pipeline, the steps for creating a send pipeline are exactly the same):
- Run Visual Studio. Select New Project -> BizTalk Projects -> Empty BizTalk Server Project. Give a name to the project and click OK.
- Go to Project -> Add New Item menu. Select Pipeline Files -> Receive Pipeline. Give a name to the pipeline and click the Open button. Visual Studio Designer displays a pipeline stack as a chain of four steps, Decode, Disassemble, Validate and ResolveParty. Each step can consist of as many corresponding primitive pipelines as needed by the logic of your application. Primitive pipelines are drag-and-dropped to the corresponding sections from the Toolbox.
- Add BizCrypto pipelines to the Toolbox by right-clicking on it and choosing Add/Remove items in the popup menu. Select BizTalk Pipeline components tab. If BizCrypto components are not present in the list, specify the location of the pipeline manually using the Browse button:
- Now drag the pipeline component from the Toolbox to the Decode section of the pipeline:
- Use Properties window to adjust the necessary properties of the pipeline. You can also set the properties after deploying the pipeline to the application using the BizTalk administration console.
- After pipeline stack is composed, build the project and deploy the resulting assembly to your BizTalk application. Remember, that your assembly must be digitally signed; BizTalk server won’t find the pipeline otherwise.
Default pipelinesFor the customers’ convenience, SecureBlackbox distribution includes a set of default pipeline stacks. Each of the default pipeline stack consists of a single corresponding encoding/decoding pipeline component. To make the default pipelines accessible to your BizTalk application, simply deploy the BizCrypto.BizTalk.DefaultPipelines assembly to the application.
TroubleshootingThe reason for most of the pipelines-related problems is an incorrect installation of the components. If either BizTalk server of Visual Studio does not see the pipelines, please check the following:
- All the SecureBlackbox.*.dll and BizCrypto.*.dll assemblies are added to the GAC,
- BizCrypto.BizTalk.Pipelines.*.dll assemblies are present in %BTS%\Pipeline Components directory. %BTS% here is the path to BizTalk server installation that usually looks like C:\Program Files\Microsoft BizTalk Server 2006.