Skip to content

Commit 6b5937f

Browse files
author
AWS
committed
Private CA Connector for SCEP Update: AWS Private CA Connector for SCEP now supports AWS PrivateLink, allowing your clients to request certificates from within your Amazon Virtual Private Cloud (VPC) without traversing the public internet. With this launch, you can create VPC endpoints to connect to your SCEP connector privately.
1 parent 059bc2b commit 6b5937f

File tree

2 files changed

+38
-14
lines changed

2 files changed

+38
-14
lines changed
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Private CA Connector for SCEP",
4+
"contributor": "",
5+
"description": "AWS Private CA Connector for SCEP now supports AWS PrivateLink, allowing your clients to request certificates from within your Amazon Virtual Private Cloud (VPC) without traversing the public internet. With this launch, you can create VPC endpoints to connect to your SCEP connector privately."
6+
}

services/pcaconnectorscep/src/main/resources/codegen-resources/service-2.json

Lines changed: 32 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -23,16 +23,16 @@
2323
"input":{"shape":"CreateChallengeRequest"},
2424
"output":{"shape":"CreateChallengeResponse"},
2525
"errors":[
26-
{"shape":"ResourceNotFoundException"},
2726
{"shape":"BadRequestException"},
27+
{"shape":"ResourceNotFoundException"},
2828
{"shape":"InternalServerException"},
2929
{"shape":"ValidationException"},
3030
{"shape":"ThrottlingException"},
3131
{"shape":"AccessDeniedException"},
3232
{"shape":"ConflictException"},
3333
{"shape":"ServiceQuotaExceededException"}
3434
],
35-
"documentation":"<p>For general-purpose connectors. Creates a <i>challenge password</i> for the specified connector. The SCEP protocol uses a challenge password to authenticate a request before issuing a certificate from a certificate authority (CA). Your SCEP clients include the challenge password as part of their certificate request to Connector for SCEP. To retrieve the connector Amazon Resource Names (ARNs) for the connectors in your account, call <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_ListConnectors.html\">ListConnectors</a>.</p> <p>To create additional challenge passwords for the connector, call <code>CreateChallenge</code> again. We recommend frequently rotating your challenge passwords.</p>"
35+
"documentation":"<p>For general-purpose connectors. Creates a <i>challenge password</i> for the specified connector. The SCEP protocol uses a challenge password to authenticate a request before issuing a certificate from a certificate authority (CA). Your SCEP clients include the challenge password as part of their certificate request to Connector for SCEP. To retrieve the connector Amazon Resource Names (ARNs) for the connectors in your account, call <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_ListConnectors.html\">ListConnectors</a>.</p> <p>To create additional challenge passwords for the connector, call <code>CreateChallenge</code> again. We recommend frequently rotating your challenge passwords.</p>"
3636
},
3737
"CreateConnector":{
3838
"name":"CreateConnector",
@@ -70,7 +70,7 @@
7070
{"shape":"AccessDeniedException"},
7171
{"shape":"ConflictException"}
7272
],
73-
"documentation":"<p>Deletes the specified <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_Challenge.html\">Challenge</a>.</p>",
73+
"documentation":"<p>Deletes the specified <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_Challenge.html\">Challenge</a>.</p>",
7474
"idempotent":true
7575
},
7676
"DeleteConnector":{
@@ -89,7 +89,7 @@
8989
{"shape":"AccessDeniedException"},
9090
{"shape":"ConflictException"}
9191
],
92-
"documentation":"<p>Deletes the specified <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_Connector.html\">Connector</a>. This operation also deletes any challenges associated with the connector.</p>",
92+
"documentation":"<p>Deletes the specified <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_Connector.html\">Connector</a>. This operation also deletes any challenges associated with the connector.</p>",
9393
"idempotent":true
9494
},
9595
"GetChallengeMetadata":{
@@ -108,7 +108,8 @@
108108
{"shape":"ThrottlingException"},
109109
{"shape":"AccessDeniedException"}
110110
],
111-
"documentation":"<p>Retrieves the metadata for the specified <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_Challenge.html\">Challenge</a>.</p>"
111+
"documentation":"<p>Retrieves the metadata for the specified <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_Challenge.html\">Challenge</a>.</p>",
112+
"readonly":true
112113
},
113114
"GetChallengePassword":{
114115
"name":"GetChallengePassword",
@@ -126,7 +127,8 @@
126127
{"shape":"ThrottlingException"},
127128
{"shape":"AccessDeniedException"}
128129
],
129-
"documentation":"<p>Retrieves the challenge password for the specified <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_Challenge.html\">Challenge</a>.</p>"
130+
"documentation":"<p>Retrieves the challenge password for the specified <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_Challenge.html\">Challenge</a>.</p>",
131+
"readonly":true
130132
},
131133
"GetConnector":{
132134
"name":"GetConnector",
@@ -144,7 +146,8 @@
144146
{"shape":"ThrottlingException"},
145147
{"shape":"AccessDeniedException"}
146148
],
147-
"documentation":"<p>Retrieves details about the specified <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_Connector.html\">Connector</a>. Calling this action returns important details about the connector, such as the public SCEP URL where your clients can request certificates.</p>"
149+
"documentation":"<p>Retrieves details about the specified <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_Connector.html\">Connector</a>. Calling this action returns important details about the connector, such as the public SCEP URL where your clients can request certificates.</p>",
150+
"readonly":true
148151
},
149152
"ListChallengeMetadata":{
150153
"name":"ListChallengeMetadata",
@@ -162,7 +165,8 @@
162165
{"shape":"ThrottlingException"},
163166
{"shape":"AccessDeniedException"}
164167
],
165-
"documentation":"<p>Retrieves the challenge metadata for the specified ARN.</p>"
168+
"documentation":"<p>Retrieves the challenge metadata for the specified ARN.</p>",
169+
"readonly":true
166170
},
167171
"ListConnectors":{
168172
"name":"ListConnectors",
@@ -179,7 +183,8 @@
179183
{"shape":"ThrottlingException"},
180184
{"shape":"AccessDeniedException"}
181185
],
182-
"documentation":"<p>Lists the connectors belonging to your Amazon Web Services account.</p>"
186+
"documentation":"<p>Lists the connectors belonging to your Amazon Web Services account.</p>",
187+
"readonly":true
183188
},
184189
"ListTagsForResource":{
185190
"name":"ListTagsForResource",
@@ -197,7 +202,8 @@
197202
{"shape":"ThrottlingException"},
198203
{"shape":"AccessDeniedException"}
199204
],
200-
"documentation":"<p>Retrieves the tags associated with the specified resource. Tags are key-value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to \"customer\" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.</p>"
205+
"documentation":"<p>Retrieves the tags associated with the specified resource. Tags are key-value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to \"customer\" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.</p>",
206+
"readonly":true
201207
},
202208
"TagResource":{
203209
"name":"TagResource",
@@ -358,7 +364,7 @@
358364
"documentation":"<p>The date and time that the challenge was updated.</p>"
359365
}
360366
},
361-
"documentation":"<p>Details about the specified challenge, returned by the <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_GetChallengeMetadata.html\">GetChallengeMetadata</a> action.</p>"
367+
"documentation":"<p>Details about the specified challenge, returned by the <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_GetChallengeMetadata.html\">GetChallengeMetadata</a> action.</p>"
362368
},
363369
"ClientToken":{
364370
"type":"string",
@@ -462,7 +468,9 @@
462468
"INTERNAL_FAILURE",
463469
"PRIVATECA_ACCESS_DENIED",
464470
"PRIVATECA_INVALID_STATE",
465-
"PRIVATECA_RESOURCE_NOT_FOUND"
471+
"PRIVATECA_RESOURCE_NOT_FOUND",
472+
"VPC_ENDPOINT_RESOURCE_NOT_FOUND",
473+
"VPC_ENDPOINT_DNS_ENTRIES_NOT_FOUND"
466474
]
467475
},
468476
"ConnectorSummary":{
@@ -528,7 +536,7 @@
528536
},
529537
"ClientToken":{
530538
"shape":"ClientToken",
531-
"documentation":"<p>Custom string that can be used to distinguish between calls to the <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_CreateChallenge.html\">CreateChallenge</a> action. Client tokens for <code>CreateChallenge</code> time out after five minutes. Therefore, if you call <code>CreateChallenge</code> multiple times with the same client token within five minutes, Connector for SCEP recognizes that you are requesting only one challenge and will only respond with one. If you change the client token for each call, Connector for SCEP recognizes that you are requesting multiple challenge passwords.</p>",
539+
"documentation":"<p>Custom string that can be used to distinguish between calls to the <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_CreateChallenge.html\">CreateChallenge</a> action. Client tokens for <code>CreateChallenge</code> time out after five minutes. Therefore, if you call <code>CreateChallenge</code> multiple times with the same client token within five minutes, Connector for SCEP recognizes that you are requesting only one challenge and will only respond with one. If you change the client token for each call, Connector for SCEP recognizes that you are requesting multiple challenge passwords.</p>",
532540
"idempotencyToken":true
533541
},
534542
"Tags":{
@@ -558,9 +566,13 @@
558566
"shape":"MobileDeviceManagement",
559567
"documentation":"<p>If you don't supply a value, by default Connector for SCEP creates a connector for general-purpose use. A general-purpose connector is designed to work with clients or endpoints that support the SCEP protocol, except Connector for SCEP for Microsoft Intune. With connectors for general-purpose use, you manage SCEP challenge passwords using Connector for SCEP. For information about considerations and limitations with using Connector for SCEP, see <a href=\"https://docs.aws.amazon.com/privateca/latest/userguide/scep-connector.htmlc4scep-considerations-limitations.html\">Considerations and Limitations</a>.</p> <p>If you provide an <code>IntuneConfiguration</code>, Connector for SCEP creates a connector for use with Microsoft Intune, and you manage the challenge passwords using Microsoft Intune. For more information, see <a href=\"https://docs.aws.amazon.com/privateca/latest/userguide/scep-connector.htmlconnector-for-scep-intune.html\">Using Connector for SCEP for Microsoft Intune</a>.</p>"
560568
},
569+
"VpcEndpointId":{
570+
"shape":"VpcEndpointId",
571+
"documentation":"<p>If you don't supply a value, by default Connector for SCEP creates a connector accessible over the public internet. If you provide a VPC endpoint ID, creates a connector accessible only through that specific VPC endpoint.</p>"
572+
},
561573
"ClientToken":{
562574
"shape":"ClientToken",
563-
"documentation":"<p>Custom string that can be used to distinguish between calls to the <a href=\"https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_CreateChallenge.html\">CreateChallenge</a> action. Client tokens for <code>CreateChallenge</code> time out after five minutes. Therefore, if you call <code>CreateChallenge</code> multiple times with the same client token within five minutes, Connector for SCEP recognizes that you are requesting only one challenge and will only respond with one. If you change the client token for each call, Connector for SCEP recognizes that you are requesting multiple challenge passwords.</p>",
575+
"documentation":"<p>Custom string that can be used to distinguish between calls to the <a href=\"https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_CreateChallenge.html\">CreateChallenge</a> action. Client tokens for <code>CreateChallenge</code> time out after five minutes. Therefore, if you call <code>CreateChallenge</code> multiple times with the same client token within five minutes, Connector for SCEP recognizes that you are requesting only one challenge and will only respond with one. If you change the client token for each call, Connector for SCEP recognizes that you are requesting multiple challenge passwords.</p>",
564576
"idempotencyToken":true
565577
},
566578
"Tags":{
@@ -976,6 +988,12 @@
976988
"UNKNOWN_OPERATION",
977989
"OTHER"
978990
]
991+
},
992+
"VpcEndpointId":{
993+
"type":"string",
994+
"max":22,
995+
"min":13,
996+
"pattern":"vpce-[0-9a-f]{8}([0-9a-f]{9})?"
979997
}
980998
},
981999
"documentation":"<p>Connector for SCEP creates a connector between Amazon Web Services Private CA and your SCEP-enabled clients and devices. For more information, see <a href=\"https://docs.aws.amazon.com/privateca/latest/userguide/scep-connector.htmlconnector-for-scep.html\">Connector for SCEP</a> in the <i>Amazon Web Services Private CA User Guide</i>.</p>"

0 commit comments

Comments
 (0)