![](<https://www.versio.io/img/icons/ssl.svg>)

# SSL certificate importer

Versio.io can import, historize and process monitoring data from SSL certificates.

## Configuration

You can find the configuration option in Versio.io at `Environment settings > OneImporter > Configurations > SSL configuration`.

Here you can edit all existing configurations, create new configurations or delete existing configurations. Each configuration can import multiple SSL certificates into a single specified entity. To add a new configuration, enter a `Name` and click `Add` to proceed to the configuration. To edit an existing configuration, click the arrow on the left of your importer name to expand the configuration options.

The following configuration options are available:

| Field | Description | Advice |
| --- | --- | --- |
| **Name** | Meaningful name | Include information about the certificate |
| **Active** | Option to activate and deactivate the configuration. Data is only imported if the configuration is activated. |  |
| **Domain, host &amp; IP** | Enter either the domain, host or IP address from which to import SSL certificates | See table below for valid input formats |
| **Entity name** | Name of the entity that imported instances are assigned to | Determine standards about entity names before your first import |
| **Executing OneImporter** | Select a Versio.io OneImporter to import the data based on the importer configuration. | Requires an installed OneImporter: [Installation instructions](<https://docs.versio.io/setup-one-importer/index.md>) |
| **Schedule time (cron format)** | Determine the frequency of imports in CRON format | Learn more about CRON format: [https://en.wikipedia.org/wiki/Cron](<https://en.wikipedia.org/wiki/Cron>) |

*Table: SSL certificate configuration parameters*

The following specifications for domains, hosts and IPs are permitted:

| Type of domain, host &amp; port argument | Example | Default port |
| --- | --- | --- |
| Domain without port | my-ip | 443 |
| Domain with port | my-ip:8888 | \- |
| IPv4 without port | 192.168.0.111 | 443 |
| IPv4 with port | 192.168.0.111:8888 | \- |
| IPv6 without port | 2b01:3f8:c2c:d1b8:0:0:0:1 | 443 |
| IPv6 without port (bracketed) | \[2b01:3f8:c2c:d1b8:0:0:0:1\] | 443 |
| IPv6 with port | \[2b01:3f8:c2c:d1b8:0:0:0:1\]:8888 | \- |

*Table: Domain, host &amp; port argument inputs*

The following image is an example of a configuration in Versio.io for imports of SSL certificates:

![Versio.io SSL certificate configuration](<https://docs.versio.io/img/importer/ssl-certificate/ssl-certificate-configuration.png>) *Figure: Example of a configuration in Versio.io for imports of SSL certificates*

## Example

The Versio.io OneImporter imports SSL certificates based on your specific configuration and stores the different instances in the entity defined by you. To view the imported instances in Versio.io, you can select 'Asset &amp; Configuration Repository → Instance Viewer'. There you can select your specific instance and click it for a detailed view in the instance history viewer.

The following image is an example of an imported SSL certificate:

![Versio.io SSL certificate instance](<https://docs.versio.io/img/importer/ssl-certificate/ssl-certificate-instance.png>) *Figure: Example of an SSL certificate instance*
