Documentation Manager - Prerequisites
Prerequisites
Starting with these areas first will serve you well as you enter the rest of your documentation within the Apps and Services section, some of which will self-populate for ease-of-use to allow you to get started.
Expand the below for more information on each area.
Domains
To populate Domain information:
- Navigate to the Domains area via the main menu. This can be accessed via the Company Vault or Clients:
- Ensure the correct client is selected in the Client dropdown at the top of the screen. Click the + Add Domain button.
- Enter a name for the Domain Tracker.
- Enter the Domain Name to be tracked.
- Click Preview to view the gathered DNS detail and WhoIs information for the domain to verify it is accurate. Passportalwill pull all relevant information and will continue to update this once a day
- You can Link Items although this will happen naturally as you complete the Apps & Services section or add Tags via the Details tab for easier searching.
- Click Save to finish.
- You can also refresh the information anytime from the domain list the Actions menu by selecting Refresh.
SSL Certificates
Due to security constraints, in order to add a SSL Certificate, it must be a valid certificate. The chain that the SSL Certificate is a part of must also must be valid. If the chain or certificate is invalid in anyway, Passportal will respond with an error advising No SSL Certificate Found, Your certificate failed to validate and can not be added at this time or similar. You may need to use an online SSL Certificate checker to validate your SSL certificate and its chain. Any issues with the chain or SSL Certificate must be addressed before re-attempting to add the SSL Certificate to Passportal.
To populate SSL Certificates:
- Navigate to the SSL Certificates area via the main menu. This can be accessed via the Company Vault or Clients:
- Ensure the correct client is selected in the Client dropdown at the top of the screen. Click the + Add SSL Certificate button.
- Enter a name for the SSL Certificate.
- Enter only one of the following:
- Certificate Host (for active SSL Certificates) URL
- The PEM encoded Certificate (for inactive SSL Certificates)
- Click Preview to view the gathered details to ensure they are as expected.
- Enter the Certificate Details as required.
- You can link other items although this will happen naturally as you complete the Apps & Services section or add Tags via the Details tab for easier searching.
- Click Save to finish.
- You can also refresh the information anytime from the domain list the Actions menu by selecting Refresh.
Assets
Assets appear on nearly every page so having a good start here will serve you well throughout the rest of the product. An Asset is any device, from Printers, Domain Controllers, Servers, Firewalls, Switches, to any other device you need a record of.
There is a Generic Asset Template to aid you recording device details. You can create custom asset templates to help ensure a standardization of recorded details for different device types. For further information on custom templates please see: Using and Managing Document Templates in Documentation Manager.
To record asset details:
- Navigate to the Assets area via the main menu. This can be accessed via the Company Vault or Clients.
- Ensure the correct client is selected in the Client dropdown at the top of the screen. Click the + Create Generic Asset button.
- If you have created custom templates for assets, click the + Add Assets button to see a dropdown menu of available asset templates to select from.
- The + Create Generic Assetoption is used for the remainder of this section of the guide.
- Enter the Asset Title.
- The Generic Asset Template contains various sections to record the asset information. Enter the asset details for each section. (These sections may be different if using a Custom Template).
- Asset Information:
- Purchase Information:
- Location Information:
- Device Information:
Type - Should you find the generic asset template does not include an asset type that you need to record, you will need to edit the template and add the asset type you require to the dropdown menu selectable options. See Editing Templates for template editing and Select Box (Dropdown) for details on adding to the dropdown menu
- You can link other items although this will happen naturally as you complete the Apps & Services section or add Tags via the Details tab for easier searching.
- Click Save to finish.
Vendors
Vendors are available across all clients.
To add a vendor:
- Navigate to the Vendors area via the main menu. This can be accessed via the Company Vault or Clients.
- Click the + New Vendor button.
- Enter a Title and populate the vendor details in the appropriate fields.
- You can link other items although this will happen naturally as you complete the Apps & Services section or add Tags for easier searching.
- Click Save to finish.
Licensing
Licenses are contained within individual clients.
To add a License:
- Navigate to the Licensing area via the main menu. This can be accessed via the Company Vault or Clients.
- Click the + Create Licensing button.
- Enter the License Title.
- Select the Manufacturer from the dropdown menu (which is populated with your added Vendors).
- Enter the remaining License details.
- You can link other items although this will happen naturally as you complete the Apps & Services section or add Tags via the Details tab for easier searching.
- Click Save to finish.