Skip to main content

WinMagic SecureDoc

Connector name

agtwinmagicsd

Connector type

Executable

Type (UI field value)

WinMagic SecureDoc

Target system versions supported / tested

The agtwinmagicsd connector is known to work with version 8.3 of WinMagic SecureDoc; other versions may work.

Connector status / support

Bravura Security-Verified

This connector has been tested and is fully supported by Bravura Security.

Installation / setup

A WinMagic SecureDoc target uses two sets of administrative credentials. One is a WinMagic SecureDoc server administrator, the other administrator is a WinMagic SecureDoc database administrator which should be identified with System password . The database administrator is optional and is needed only for listing operation.

The following Bravura Security Fabric operations are supported by this connector (depending on your product license and version):

  • challenge response authentication

  • List:

    • accounts

For a full list and explanation of each connector operation, see connector operations.

Preparation

Before you can target WinMagic SecureDoc, you must:

  • Set up a target system administrator.

Setting up a target system administrator

Bravura Security Fabric uses two sets of credentials to perform Bravura Security Fabric operations. A designated account on WinMagic SecureDoc Enterprise Server and a database administrator on WinMagic SecureDoc SQL database. The database administrator is needed for listing accounts only.

The WinMagic SecureDoc administrator requires permissions of "Manage Users" role and "API Access" role, whereas the database administrator requires "Read" permission on WinMagic SecureDoc SQL database.

You can create a WinMagic SecureDoc administrator via the WinMagic SecureDoc Enterprise Server (SES) Web Console user rights assignment process:

  1. Open a browser and log into the SES Web Console.

  2. Click Configuration > Administrator Management.

  3. Click on the down arrow next to Administrators.

  4. Click Add New Administrator.

  5. Select a user on the Select user page.

  6. Click Add.

  7. Click on the down arrow next to Administrators.

  8. Click Manage Roles .

  9. Click on the down arrow next to Administrators.

  10. Click Add New Role if there is none available.

  11. Type the Name and Description for the new role.

  12. Select Manage Users and API Access from the rights list box.

  13. Click Save.

  14. Click Configuration > Administrator Management to select the administrator.

  15. Click on the down arrow next to Administrators.

  16. Select View Properties.

  17. Click on the Permissions tab.

  18. Click on the down arrow next to Administrators.

  19. Select Assign Role to Admin if the role is not already listed.

  20. Select the role and click OK.

  21. Check to ensure Manage Users and API Access rights are listed.

Targeting the WinMagic SecureDoc system

For each WinMagic SecureDoc system, add a target system in Bravura Security Fabric (Manage the System > Resources > Target systems):

  • Type is WinMagic SecureDoc.

  • Address uses the following options:

    The address is entered as follows:

    {server=<winmagic securedoc server>/[;port=<port number>;]/[;dbserver=<dbserver>;]/[;dbname=<dbname>;]...}

The full list of target parameters is explained in Target System Options .

Table 1. WinMagic SecureDoc address configuration

Option

Description

Options marked with a redstar.png are required.

Server redstar.png

The IP address/domain name of the WinMagic SecureDoc Enterprise Server.

(key: server)

Port

The SecureDoc web API port. Default is 44302.

(key: port)

Connection over SSL

Select to enforce SSL connections. Default is "true".

(key: ssl)

Validate the server’s certificate when connecting

Determines whether to validate the server’s security certificate for SSL connections. Default is "true".

(key: checkCert)

HTTP Network Proxy

(optional) HTTP proxy server to use for making API calls.

(key: proxy)

Database server name

(optional) The back-end SQL database server used by WinMagic SecureDoc.

(key: dbserver)

Database name

(optional) The name of WinMagic SecureDoc’s database.

(key: dbname)

ODBC Driver

(optional) Select an ODBC driver available on the system.

(key: driver)



Setting the administrator credentials

A WinMagic SecureDoc target uses two sets of administrative credentials. One is a WinMagic SecureDoc server administrator, the other administrator is a WinMagic SecureDoc database administrator which should be identified with System password. The database administrator is optional and is needed only for listing operation.

The target should now be able to connect and interact with the WinMagic SecureDoc API.

Handling account attributes

You can view the complete list of attributes that Bravura Security Fabric can manage, including native and pseudo-attributes, using the Manage the system (PSA) module. To do this, select WinMagic SecureDoc from the Manage the system > Resources > Account attributes > Target system type menu.

For information about the native WinMagic SecureDoc attributes managed by Bravura Security Fabric , consult your WinMagic SecureDoc documentation.

In this section: