Create RA Profile
When the connection with the Authority is successfully established, we can create a service for certificate management. We call it RA Profile.
Create RA Profile using the API
RA Profile can be created using the RA Profile API. However, before creating it, we need know the required Attributes for the RA Profile.
We can get that using the Authority API and the following request:
curl -X GET \
--cacert [ca-cert] \
--cert [client-cert] \
--cert-type [type] \
-H "Accept: application/json" \
https://[domain]:[port]/api/v1/authorities/83265efb-35a1-4b48-ae6f-1269b7c41668/raProfiles/attributes
#https://[domain]:[port]/api/v1/authorities/{uuid}/raProfiles/attributes
This returns the list of applicable attributes for the RA Profile, such as:
[
{
"uuid": "87a94421-c5d8-4a23-bb2c-bbee76cb4ea9",
"name": "template",
"content": [
{
"value": "CodeSigning"
},
{
"value": "EnrollmentAgent"
},
...
{
"value": "SubCA"
},
{
"value": "Administrator"
}
],
"label": "Template",
"type": "STRING",
"required": true,
"readOnly": false,
"visible": true,
"list": true,
"multiSelect": false
},
{
"uuid": "1467ffaa-445c-11ec-81d3-0242ac130003",
"name": "caAdcs",
"content": [
{
"value": "vmi307469.example.local\\Demo MS Sub CA"
}
],
"label": "Certification Authority",
"type": "STRING",
"required": true,
"readOnly": false,
"visible": true,
"list": true,
"multiSelect": false
}
]
Knowing the attributes, we can create the RA Profile using the following request:
curl -X POST \
--cacert [ca-cert] \
--cert [client-cert] \
--cert-type [type] \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '
{
"name": "Web Server RA Profile",
"authorityInstanceUuid": "83265efb-35a1-4b48-ae6f-1269b7c41668",
"description": "Quick start",
"enabled": true,
"attributes": [
{
"name": "template",
"content": {
"value": "WebServer"
}
},
{
"name": "caAdcs",
"content": {
"value": "vmi307469.example.local\\Demo MS Sub CA"
}
}
]
}' \
https://[domain]:[port]/api/v1/authorities/83265efb-35a1-4b48-ae6f-1269b7c41668/raProfiles
#https://[domain]:[port]/api/v1/authorities/{uuid}/raProfiles
When the RA Profile is successfully created, its uuid is sent back:
{
"uuid": "e045a12a-e114-45ed-90b8-bac7e750e803"
}
Create RA Profile using the Web Interface
Create RA Profile to manage certificates with the specific certificate template.
- Click RA Profiles in the left menu
- Click Add new RA Profile (plus symbol )
- Fill the columns with the attributes:
- RA Profile Name:
ADCS-WebServer - Description:
RA profile for webserver certificates - Select Authority:
MS ADCS authority - Template:
WebServer - Certification Authority: your system certificate authority
- RA Profile Name:
- Click Create
- Click Enable to make RA Profile ready for using, the RA Profile Status would be changed to
Enabled.
Configure request attributes
Request attributes define what the requester fills in on the certificate request form and where each value lands in the issued certificate. This section walks through authoring them; for the why and how they are resolved, see Request Attribute.
-
Click RA Profiles in the left menu and open the
RA Profilecreated above -
Click Edit to open the Edit RA Profile dialog
-
Switch to the Request Attributes tab
noteThe Request Attributes tab needs an
Authority. When creating a newRA Profile, select an authority first — the dialog tells you: Select an authority to configure request attributes. -
In the Authored attributes section, click + Add request attribute and fill in the dialog:
- Name — internal identifier, unique within this set; not shown to the requester
- Label — the name shown to the requester on the request form
- Description — optional help text shown to the requester explaining what to enter
- Content type — the data type of the value the requester provides
- Required, List, Multi select, Read Only — checkboxes controlling how the form field behaves; a read-only attribute needs a Default value
- Validation pattern, Validation error message and Validation description — an optional regular expression the value must match
- JSON Schema — an optional inline JSON Schema (draft 2020-12) the value must conform to, with Schema error message and Schema description; remote references are not supported. It applies to string and text attributes and suits extension values written in JER
-
In the Mapping targets section, pick the Target — where the value lands in the certificate. Use Add mapping target to write the same value to several targets; the targets are applied in the order listed:
- RDN (subject) — a component of the certificate subject name (e.g. CN, O); select the RDN below. Careful with the codes:
SNis Surname (2.5.4.4), not serial number — the subject Serial Number (SERIALNUMBER,2.5.4.5) is a separate entry, and neither has any relationship to the issued certificate's serial number. A mispick is a valid mapping that no validation will reject. - Subject Alternative Name — select the SAN type below:
dNSName,rfc822Name (email),iPAddress,uniformResourceIdentifier,otherName,directoryName, orregisteredID; forotherName, also fill otherName OID and otherName value encoding - Certificate extension — select the Extension below; Key Usage, Extended Key Usage and Subject Alternative Name are not offered here
- Key Usage — select the Permitted key usages; mark the attribute as a list
- Extended Key Usage — select the Permitted purposes; mark the attribute as a list
- RDN (subject) — a component of the certificate subject name (e.g. CN, O); select the RDN below. Careful with the codes:
-
Choose the Value source:
- Free input — the requester types any value
- Static list — the requester picks from a fixed set of values you define below; add them in the Static list values section with Add value (at least one value, values must be unique)
-
Click Save to add the attribute; repeat for every attribute you need. Use Edit and Remove on the rows to adjust the set later.
-
Choose the Merge mode — how the attributes authored here combine with the ones the authority connector declares:
- Static only — only the attributes authored here are used (the default)
- Connector only — only the connector's attributes are used
- Merge — both are combined; where both define an attribute, the connector's definition wins
-
If the connector supplies attributes, you can attach a different value source to one of them in Value-source bindings: click to add a binding, pick the Connector attribute (or enter its Attribute UUID or Attribute name) and choose the Value source. The platform default set applies only when the resulting set is empty, as shown in the Request Attributes widget of the profile
-
Click Update — changes are saved when you click Update
See Merge mode for how the sets combine.
The options offered for RDN, Extension and Permitted purposes come from the OID registry: built-in system entries plus the entries you register under Custom OIDs. The common standards-track extensions are built in; a vendor-specific Certificate Extension OID must be registered there before you can map an attribute to it. To write an extension's value in JER, the OID needs an ASN.1 module.
The set is validated when you click Update: every attribute must declare a field mapping, attributes mapped to an RDN, SAN or extension must use string or text content, RDN codes and extension OIDs must be known to the OID registry, and an extension OID may appear only once per attribute. Failures are reported per attribute with the reason.
Configure external CSR validation
When a client supplies its own CSR, the profile validates it against the resolved request-attribute set in strict or lenient mode — see External CSR validation for what the modes mean and what is checked.
To configure it, open the profile detail and switch to the Validation tab. The Request Validation widget shows the effective mode. Click the pencil icon (Edit Request Validation Settings); the switch Use Platform Request Validation Settings controls whether the profile follows the platform default or sets its own mode. With the switch off, choose Strict (non-compliant external CSRs are rejected) or Lenient (non-compliant external CSRs are accepted).