Skip to main content

Discovery Provider

info

This page describes the v1 Discovery Provider, which discovers certificates. Discovery Provider v2 discovers certificates and keys, collects results while a run is in progress, and supports stopping, resuming and cancelling a run.

Overview​

Certificate discovery, in other words searching for certificates in various location and sources, is important part of the lifecycle management. It provides clear understanding and visibility on all certificates that are used in the infrastructure and therefore should be included in the inventory to start manage them. Discovery can also detect certificates that are not allowed or should not be deployed.

Discovery Providers implements the functionality to discover certificate. It is responsible for discovering the certificates from defined source and returning the list of certificates to the Core inventory and makes it available for various lifecycle management operations.

How it works​

Discovery Provider triggers the discovery process using specific configuration. The trigger is managed from Core. Once the certificate discovery process is initiated, platform periodically checks for the discovered certificates that are included in the certificate inventory.

The history of Discovery is maintained in the Core for further reference.

Provider objects​

Discovery objects are managed in the platform through the Discovery Provider implementation. Each Discovery provides an overview of the configuration and the discovery process, including discovered certificates.

Processes​

The following processes are associated with the Discovery Provider and management of the Discovery objects.

Create Discovery​

Create Discovery diagram

Create Discovery diagram

100%Scroll to explore · Esc to close
Create Discovery diagram
Create Discovery diagram
Open full diagram ↗

Get Discovery Details​

Get Discovery Details diagram

Get Discovery Details diagram

100%Scroll to explore · Esc to close
Get Discovery Details diagram
Get Discovery Details diagram
Open full diagram ↗

Delete Discovery​

A v1 Discovery can be deleted at any time, including while it is in progress. Core removes its own record first, and then asks the Connector to remove the discovery. A failure at the Connector is logged and does not restore the record.

Delete Discovery diagram

Delete Discovery diagram

100%Scroll to explore · Esc to close
Delete Discovery diagram
Delete Discovery diagram
Open full diagram ↗

A v2 discovery is deleted differently: it can be deleted only once it has ended, and its Connector is never asked to delete anything. See Discovery Provider v2.

Specification and example​

The Discovery Provider implements Common Interfaces and the following additional interfaces:

The OpenAPI specification of the Discovery Provider can be found here: Connector API - Discovery Provider.