Skip to content

Commit 8528ad2

Browse files
Add initial hub guide for adding a new certificate
1 parent a3352e8 commit 8528ad2

File tree

2 files changed

+35
-3
lines changed

2 files changed

+35
-3
lines changed
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Requesting a Certificate
2+
3+
:::info Before We Start - What is a Target Instance?
4+
5+
Unique to *Certify Management Hub*, each managed certificate configuration and settings can either be set up on the *Management Hub* server (the default *Target Instance*) or on an instance of *Certify Certificate Manager* which has joined the hub. All managed certificates and settings can be configured via the one Management Hub user interface. The instance which will store the request configuration and perform the certificate request is called the **Target Instance**
6+
7+
:::
8+
9+
10+
# Configure a certificate authority
11+
A Certificate Authority is an entity which issues certificates (public or private). Before you can request a certificate you may need to configure a Certificate Authority ACME account on your target instance (where the certificate order will take place). To do so using the hub, go to *Settings* > *Certificate Authorities*, confirm your Target Instance selection and select *Add*.
12+
13+
- [Let's Encrypt](https://letsencrypt.org) is the default CA. You can optionally enter an email address for contact about certificate renewal issues, then agree to the CAs terms and conditions and click OK. Note that omitting an email address will also prevent automated failure notifications provided by the certifytheweb.com API.
14+
15+
- For some CAs you can optionally select "Use Staging" to only create a test account which creates test (not publicly trusted) certificates. If you select this option you also need to indicate that you will use Staging in your certificate settings later.
16+
17+
# Requesting your first certificate
18+
19+
Ordering a certificate from a CA requires specifying which identifiers (domains) you want to include and proving you control those identifiers.
20+
21+
To add a new managed certificate:
22+
1. select *Certificates* > *New*
23+
- the *Target Instance* will default to the mangement hub server, but if you can optionally select a target Certify Certificate Manager instance (the instance must have already joined the hub).
24+
2. Provide a descriptive title for your certificate (for your own reference) and add the set of domains you want to include.
25+
3. On the *Authorization* tab, configure how to prove domain control by adding one or more challenge-response configurations. If your domain points to the same server as the *Target Instance* then that instance can provide HTTP domain validation responses. Otherwise, select dns-01 as the challenge type and configure an appropriate DNS validation method.
26+
27+
:::info
28+
29+
Note: If you intend to create a test certificate against the Staging version of a CA, select *Certificate* > *Advanced* > *Certificate Authority*, select your CA and check *Use Staging Mode*.
30+
31+
:::

sidebars.js

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,11 +102,12 @@ export default {
102102
items: [
103103
'hub/installation/index',
104104
'hub/installation/containers',
105-
'hub/installation/windows'
105+
'hub/installation/windows',
106+
'hub/guides/ccm',
106107
],
107108
},
108-
'hub/known-issues',
109-
'hub/guides/ccm'
109+
'hub/guides/request-certificate',
110+
'hub/known-issues'
110111
]
111112
},
112113
{

0 commit comments

Comments
 (0)