ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud
ibm.getSmPrivateCertificateConfigurationTemplate
Explore with Pulumi AI
Provides a read-only data source for the configuration of a private certificate template. You can then reference the fields of the data source in other resources within the same configuration using interpolation syntax.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as ibm from "@pulumi/ibm";
const privateCertificateTemplate = ibm.getSmPrivateCertificateConfigurationTemplate({
instanceId: ibm_resource_instance.sm_instance.guid,
region: "us-south",
name: "configuration-name",
});
import pulumi
import pulumi_ibm as ibm
private_certificate_template = ibm.get_sm_private_certificate_configuration_template(instance_id=ibm_resource_instance["sm_instance"]["guid"],
region="us-south",
name="configuration-name")
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := ibm.LookupSmPrivateCertificateConfigurationTemplate(ctx, &ibm.LookupSmPrivateCertificateConfigurationTemplateArgs{
InstanceId: ibm_resource_instance.Sm_instance.Guid,
Region: pulumi.StringRef("us-south"),
Name: "configuration-name",
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ibm = Pulumi.Ibm;
return await Deployment.RunAsync(() =>
{
var privateCertificateTemplate = Ibm.GetSmPrivateCertificateConfigurationTemplate.Invoke(new()
{
InstanceId = ibm_resource_instance.Sm_instance.Guid,
Region = "us-south",
Name = "configuration-name",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IbmFunctions;
import com.pulumi.ibm.inputs.GetSmPrivateCertificateConfigurationTemplateArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var privateCertificateTemplate = IbmFunctions.getSmPrivateCertificateConfigurationTemplate(GetSmPrivateCertificateConfigurationTemplateArgs.builder()
.instanceId(ibm_resource_instance.sm_instance().guid())
.region("us-south")
.name("configuration-name")
.build());
}
}
variables:
privateCertificateTemplate:
fn::invoke:
function: ibm:getSmPrivateCertificateConfigurationTemplate
arguments:
instanceId: ${ibm_resource_instance.sm_instance.guid}
region: us-south
name: configuration-name
Using getSmPrivateCertificateConfigurationTemplate
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getSmPrivateCertificateConfigurationTemplate(args: GetSmPrivateCertificateConfigurationTemplateArgs, opts?: InvokeOptions): Promise<GetSmPrivateCertificateConfigurationTemplateResult>
function getSmPrivateCertificateConfigurationTemplateOutput(args: GetSmPrivateCertificateConfigurationTemplateOutputArgs, opts?: InvokeOptions): Output<GetSmPrivateCertificateConfigurationTemplateResult>
def get_sm_private_certificate_configuration_template(endpoint_type: Optional[str] = None,
id: Optional[str] = None,
instance_id: Optional[str] = None,
name: Optional[str] = None,
region: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetSmPrivateCertificateConfigurationTemplateResult
def get_sm_private_certificate_configuration_template_output(endpoint_type: Optional[pulumi.Input[str]] = None,
id: Optional[pulumi.Input[str]] = None,
instance_id: Optional[pulumi.Input[str]] = None,
name: Optional[pulumi.Input[str]] = None,
region: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetSmPrivateCertificateConfigurationTemplateResult]
func LookupSmPrivateCertificateConfigurationTemplate(ctx *Context, args *LookupSmPrivateCertificateConfigurationTemplateArgs, opts ...InvokeOption) (*LookupSmPrivateCertificateConfigurationTemplateResult, error)
func LookupSmPrivateCertificateConfigurationTemplateOutput(ctx *Context, args *LookupSmPrivateCertificateConfigurationTemplateOutputArgs, opts ...InvokeOption) LookupSmPrivateCertificateConfigurationTemplateResultOutput
> Note: This function is named LookupSmPrivateCertificateConfigurationTemplate
in the Go SDK.
public static class GetSmPrivateCertificateConfigurationTemplate
{
public static Task<GetSmPrivateCertificateConfigurationTemplateResult> InvokeAsync(GetSmPrivateCertificateConfigurationTemplateArgs args, InvokeOptions? opts = null)
public static Output<GetSmPrivateCertificateConfigurationTemplateResult> Invoke(GetSmPrivateCertificateConfigurationTemplateInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetSmPrivateCertificateConfigurationTemplateResult> getSmPrivateCertificateConfigurationTemplate(GetSmPrivateCertificateConfigurationTemplateArgs args, InvokeOptions options)
public static Output<GetSmPrivateCertificateConfigurationTemplateResult> getSmPrivateCertificateConfigurationTemplate(GetSmPrivateCertificateConfigurationTemplateArgs args, InvokeOptions options)
fn::invoke:
function: ibm:index/getSmPrivateCertificateConfigurationTemplate:getSmPrivateCertificateConfigurationTemplate
arguments:
# arguments dictionary
The following arguments are supported:
- Instance
Id string - The GUID of the Secrets Manager instance.
- Name string
- The name of the configuration.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- Endpoint
Type string - The endpoint type. If not provided the endpoint type is determined by the
visibility
argument provided in the provider configuration.- Constraints: Allowable values are:
private
,public
.
- Constraints: Allowable values are:
- Id string
- The unique identifier of the data source.
- Region string
- The region of the Secrets Manager instance. If not provided defaults to the region defined in the IBM provider configuration.
- Instance
Id string - The GUID of the Secrets Manager instance.
- Name string
- The name of the configuration.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- Endpoint
Type string - The endpoint type. If not provided the endpoint type is determined by the
visibility
argument provided in the provider configuration.- Constraints: Allowable values are:
private
,public
.
- Constraints: Allowable values are:
- Id string
- The unique identifier of the data source.
- Region string
- The region of the Secrets Manager instance. If not provided defaults to the region defined in the IBM provider configuration.
- instance
Id String - The GUID of the Secrets Manager instance.
- name String
- The name of the configuration.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- endpoint
Type String - The endpoint type. If not provided the endpoint type is determined by the
visibility
argument provided in the provider configuration.- Constraints: Allowable values are:
private
,public
.
- Constraints: Allowable values are:
- id String
- The unique identifier of the data source.
- region String
- The region of the Secrets Manager instance. If not provided defaults to the region defined in the IBM provider configuration.
- instance
Id string - The GUID of the Secrets Manager instance.
- name string
- The name of the configuration.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- endpoint
Type string - The endpoint type. If not provided the endpoint type is determined by the
visibility
argument provided in the provider configuration.- Constraints: Allowable values are:
private
,public
.
- Constraints: Allowable values are:
- id string
- The unique identifier of the data source.
- region string
- The region of the Secrets Manager instance. If not provided defaults to the region defined in the IBM provider configuration.
- instance_
id str - The GUID of the Secrets Manager instance.
- name str
- The name of the configuration.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- endpoint_
type str - The endpoint type. If not provided the endpoint type is determined by the
visibility
argument provided in the provider configuration.- Constraints: Allowable values are:
private
,public
.
- Constraints: Allowable values are:
- id str
- The unique identifier of the data source.
- region str
- The region of the Secrets Manager instance. If not provided defaults to the region defined in the IBM provider configuration.
- instance
Id String - The GUID of the Secrets Manager instance.
- name String
- The name of the configuration.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- endpoint
Type String - The endpoint type. If not provided the endpoint type is determined by the
visibility
argument provided in the provider configuration.- Constraints: Allowable values are:
private
,public
.
- Constraints: Allowable values are:
- id String
- The unique identifier of the data source.
- region String
- The region of the Secrets Manager instance. If not provided defaults to the region defined in the IBM provider configuration.
getSmPrivateCertificateConfigurationTemplate Result
The following output properties are available:
- Allow
Any boolName - (Boolean) Determines whether to allow clients to request a private certificate that matches any common name.
- Allow
Bare boolDomains - (Boolean) Determines whether to allow clients to request private certificates that match the value of the actual domains on the final certificate.For example, if you specify
example.com
in theallowed_domains
field, you grant clients the ability to request a certificate that contains the nameexample.com
as one of the DNS values on the final certificate.Important: In some scenarios, allowing bare domains can be considered a security risk. - Allow
Glob boolDomains - (Boolean) Determines whether to allow glob patterns, for example,
ftp*.example.com
, in the names that are specified in theallowed_domains
field.If set totrue
, clients are allowed to request private certificates with names that match the glob patterns. - Allow
Ip boolSans - (Boolean) Determines whether to allow clients to request a private certificate with IP Subject Alternative Names.
- Allow
Localhost bool - (Boolean) Determines whether to allow
localhost
to be included as one of the requested common names. - Allow
Subdomains bool - (Boolean) Determines whether to allow clients to request private certificates with common names (CN) that are subdomains of the CNs that are allowed by the other certificate template options. This includes wildcard subdomains.For example, if
allowed_domains
has a value ofexample.com
andallow_subdomains
is set totrue
, then the following subdomains are allowed:foo.example.com
,bar.example.com
,*.example.com
.Note: This field is redundant if you use theallow_any_name
option. - Allowed
Domains List<string> - (List) The domains to define for the certificate template. This property is used along with the
allow_bare_domains
andallow_subdomains
options.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Allowed
Domains boolTemplate - (Boolean) Determines whether to allow the domains that are supplied in the
allowed_domains
field to contain access control list (ACL) templates. - Allowed
Other List<string>Sans - (List) The custom Object Identifier (OID) or UTF8-string Subject Alternative Names (SANs) to allow for private certificates.The format for each element in the list is the same as OpenSSL:
<oid>:<type>:<value>
where the current valid type isUTF8
. To allow any value for an OID, use*
as its value. Alternatively, specify a single*
to allow anyother_sans
input.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Allowed
Secret stringGroups - (String) Scopes the creation of private certificates to only the secret groups that you specify.This field can be supplied as a comma-delimited list of secret group IDs.
- Constraints: The maximum length is
1024
characters. The minimum length is2
characters. The value must match regular expression/(.*?)/
.
- Constraints: The maximum length is
- Allowed
Uri List<string>Sans - (List) The URI Subject Alternative Names to allow for private certificates.Values can contain glob patterns, for example
spiffe://hostname/_*
.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Basic
Constraints boolValid For Non Ca - (Boolean) Determines whether to mark the Basic Constraints extension of an issued private certificate as valid for non-CA certificates.
- string
- (String) The name of the intermediate certificate authority.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- Client
Flag bool - (Boolean) Determines whether private certificates are flagged for client use.
- Code
Signing boolFlag - (Boolean) Determines whether private certificates are flagged for code signing use.
- Config
Type string - (String) Th configuration type.
- Constraints: Allowable values are:
public_cert_configuration_ca_lets_encrypt
,public_cert_configuration_dns_classic_infrastructure
,public_cert_configuration_dns_cloud_internet_services
,iam_credentials_configuration
,private_cert_configuration_root_ca
,private_cert_configuration_intermediate_ca
,private_cert_configuration_template
.
- Constraints: Allowable values are:
- Countries List<string>
- (List) The Country (C) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Created
At string - (String) The date when a resource was created. The date format follows RFC 3339.
- Created
By string - (String) The unique identifier that is associated with the entity that created the secret.
- Constraints: The maximum length is
128
characters. The minimum length is4
characters.
- Constraints: The maximum length is
- Email
Protection boolFlag - (Boolean) Determines whether private certificates are flagged for email protection use.
- Enforce
Hostnames bool - (Boolean) Determines whether to enforce only valid host names for common names, DNS Subject Alternative Names, and the host section of email addresses.
- Ext
Key List<string>Usage Oids - (List) A list of extended key usage Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Ext
Key List<string>Usages - (List) The allowed extended key usage constraint on private certificates.You can find valid values in the Go x509 package documentation. Omit the
ExtKeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Id string
- The unique identifier of the data source.
- Instance
Id string - Key
Bits double - (Integer) The number of bits to use to generate the private key.Allowable values for RSA keys are:
2048
and4096
. Allowable values for EC keys are:224
,256
,384
, and521
. The default for RSA keys is2048
. The default for EC keys is256
. - Key
Type string - (String) The type of private key to generate.
- Constraints: Allowable values are:
rsa
,ec
.
- Constraints: Allowable values are:
- Key
Usages List<string> - (List) The allowed key usage constraint to define for private certificates.You can find valid values in the Go x509 package documentation. Omit the
KeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Localities List<string>
- (List) The Locality (L) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Max
Ttl doubleSeconds - (Integer) The maximum time-to-live (TTL) for certificates that are created by this CA in seconds.
- Name string
- Not
Before doubleDuration Seconds - (Integer) The duration in seconds by which to backdate the
not_before
property of an issued private certificate. - Organizations List<string>
- (List) The Organization (O) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Ous List<string>
- (List) The Organizational Unit (OU) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Policy
Identifiers List<string> - (List) A list of policy Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Postal
Codes List<string> - (List) The postal code values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Provinces List<string>
- (List) The Province (ST) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Region string
- Require
Cn bool - (Boolean) Determines whether to require a common name to create a private certificate.By default, a common name is required to generate a certificate. To make the
common_name
field optional, set therequire_cn
option tofalse
. - Secret
Type string - (String) The secret type. Supported types are arbitrary, certificates (imported, public, and private), IAM credentials, key-value, and user credentials.
- Constraints: Allowable values are:
arbitrary
,imported_cert
,public_cert
,iam_credentials
,kv
,username_password
,private_cert
.
- Constraints: Allowable values are:
- Serial
Number string - (String) The serial number to assign to the generated certificate. To assign a random serial number, you can omit this field.
- Constraints: The maximum length is
64
characters. The minimum length is32
characters. The value must match regular expression/[^a-fA-F0-9]/
.
- Constraints: The maximum length is
- Server
Flag bool - (Boolean) Determines whether private certificates are flagged for server use.
- Street
Addresses List<string> - (List) The street address values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Ttl
Seconds double - (Integer) The requested Time To Live, after which the certificate will be expired.
- Updated
At string - (String) The date when a resource was recently modified. The date format follows RFC 3339.
- Use
Csr boolCommon Name - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the common name (CN) from a certificate signing request (CSR) instead of the CN that's included in the data of the certificate.Does not include any requested Subject Alternative Names (SANs) in the CSR. To use the alternative names, include theuse_csr_sans
property. - Use
Csr boolSans - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the Subject Alternative Names(SANs) from a certificate signing request (CSR) instead of the SANs that are included in the data of the certificate.Does not include the common name in the CSR. To use the common name, include theuse_csr_common_name
property. - Endpoint
Type string
- Allow
Any boolName - (Boolean) Determines whether to allow clients to request a private certificate that matches any common name.
- Allow
Bare boolDomains - (Boolean) Determines whether to allow clients to request private certificates that match the value of the actual domains on the final certificate.For example, if you specify
example.com
in theallowed_domains
field, you grant clients the ability to request a certificate that contains the nameexample.com
as one of the DNS values on the final certificate.Important: In some scenarios, allowing bare domains can be considered a security risk. - Allow
Glob boolDomains - (Boolean) Determines whether to allow glob patterns, for example,
ftp*.example.com
, in the names that are specified in theallowed_domains
field.If set totrue
, clients are allowed to request private certificates with names that match the glob patterns. - Allow
Ip boolSans - (Boolean) Determines whether to allow clients to request a private certificate with IP Subject Alternative Names.
- Allow
Localhost bool - (Boolean) Determines whether to allow
localhost
to be included as one of the requested common names. - Allow
Subdomains bool - (Boolean) Determines whether to allow clients to request private certificates with common names (CN) that are subdomains of the CNs that are allowed by the other certificate template options. This includes wildcard subdomains.For example, if
allowed_domains
has a value ofexample.com
andallow_subdomains
is set totrue
, then the following subdomains are allowed:foo.example.com
,bar.example.com
,*.example.com
.Note: This field is redundant if you use theallow_any_name
option. - Allowed
Domains []string - (List) The domains to define for the certificate template. This property is used along with the
allow_bare_domains
andallow_subdomains
options.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Allowed
Domains boolTemplate - (Boolean) Determines whether to allow the domains that are supplied in the
allowed_domains
field to contain access control list (ACL) templates. - Allowed
Other []stringSans - (List) The custom Object Identifier (OID) or UTF8-string Subject Alternative Names (SANs) to allow for private certificates.The format for each element in the list is the same as OpenSSL:
<oid>:<type>:<value>
where the current valid type isUTF8
. To allow any value for an OID, use*
as its value. Alternatively, specify a single*
to allow anyother_sans
input.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Allowed
Secret stringGroups - (String) Scopes the creation of private certificates to only the secret groups that you specify.This field can be supplied as a comma-delimited list of secret group IDs.
- Constraints: The maximum length is
1024
characters. The minimum length is2
characters. The value must match regular expression/(.*?)/
.
- Constraints: The maximum length is
- Allowed
Uri []stringSans - (List) The URI Subject Alternative Names to allow for private certificates.Values can contain glob patterns, for example
spiffe://hostname/_*
.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Basic
Constraints boolValid For Non Ca - (Boolean) Determines whether to mark the Basic Constraints extension of an issued private certificate as valid for non-CA certificates.
- string
- (String) The name of the intermediate certificate authority.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- Client
Flag bool - (Boolean) Determines whether private certificates are flagged for client use.
- Code
Signing boolFlag - (Boolean) Determines whether private certificates are flagged for code signing use.
- Config
Type string - (String) Th configuration type.
- Constraints: Allowable values are:
public_cert_configuration_ca_lets_encrypt
,public_cert_configuration_dns_classic_infrastructure
,public_cert_configuration_dns_cloud_internet_services
,iam_credentials_configuration
,private_cert_configuration_root_ca
,private_cert_configuration_intermediate_ca
,private_cert_configuration_template
.
- Constraints: Allowable values are:
- Countries []string
- (List) The Country (C) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Created
At string - (String) The date when a resource was created. The date format follows RFC 3339.
- Created
By string - (String) The unique identifier that is associated with the entity that created the secret.
- Constraints: The maximum length is
128
characters. The minimum length is4
characters.
- Constraints: The maximum length is
- Email
Protection boolFlag - (Boolean) Determines whether private certificates are flagged for email protection use.
- Enforce
Hostnames bool - (Boolean) Determines whether to enforce only valid host names for common names, DNS Subject Alternative Names, and the host section of email addresses.
- Ext
Key []stringUsage Oids - (List) A list of extended key usage Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Ext
Key []stringUsages - (List) The allowed extended key usage constraint on private certificates.You can find valid values in the Go x509 package documentation. Omit the
ExtKeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Id string
- The unique identifier of the data source.
- Instance
Id string - Key
Bits float64 - (Integer) The number of bits to use to generate the private key.Allowable values for RSA keys are:
2048
and4096
. Allowable values for EC keys are:224
,256
,384
, and521
. The default for RSA keys is2048
. The default for EC keys is256
. - Key
Type string - (String) The type of private key to generate.
- Constraints: Allowable values are:
rsa
,ec
.
- Constraints: Allowable values are:
- Key
Usages []string - (List) The allowed key usage constraint to define for private certificates.You can find valid values in the Go x509 package documentation. Omit the
KeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Localities []string
- (List) The Locality (L) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Max
Ttl float64Seconds - (Integer) The maximum time-to-live (TTL) for certificates that are created by this CA in seconds.
- Name string
- Not
Before float64Duration Seconds - (Integer) The duration in seconds by which to backdate the
not_before
property of an issued private certificate. - Organizations []string
- (List) The Organization (O) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Ous []string
- (List) The Organizational Unit (OU) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Policy
Identifiers []string - (List) A list of policy Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Postal
Codes []string - (List) The postal code values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Provinces []string
- (List) The Province (ST) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Region string
- Require
Cn bool - (Boolean) Determines whether to require a common name to create a private certificate.By default, a common name is required to generate a certificate. To make the
common_name
field optional, set therequire_cn
option tofalse
. - Secret
Type string - (String) The secret type. Supported types are arbitrary, certificates (imported, public, and private), IAM credentials, key-value, and user credentials.
- Constraints: Allowable values are:
arbitrary
,imported_cert
,public_cert
,iam_credentials
,kv
,username_password
,private_cert
.
- Constraints: Allowable values are:
- Serial
Number string - (String) The serial number to assign to the generated certificate. To assign a random serial number, you can omit this field.
- Constraints: The maximum length is
64
characters. The minimum length is32
characters. The value must match regular expression/[^a-fA-F0-9]/
.
- Constraints: The maximum length is
- Server
Flag bool - (Boolean) Determines whether private certificates are flagged for server use.
- Street
Addresses []string - (List) The street address values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- Ttl
Seconds float64 - (Integer) The requested Time To Live, after which the certificate will be expired.
- Updated
At string - (String) The date when a resource was recently modified. The date format follows RFC 3339.
- Use
Csr boolCommon Name - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the common name (CN) from a certificate signing request (CSR) instead of the CN that's included in the data of the certificate.Does not include any requested Subject Alternative Names (SANs) in the CSR. To use the alternative names, include theuse_csr_sans
property. - Use
Csr boolSans - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the Subject Alternative Names(SANs) from a certificate signing request (CSR) instead of the SANs that are included in the data of the certificate.Does not include the common name in the CSR. To use the common name, include theuse_csr_common_name
property. - Endpoint
Type string
- allow
Any BooleanName - (Boolean) Determines whether to allow clients to request a private certificate that matches any common name.
- allow
Bare BooleanDomains - (Boolean) Determines whether to allow clients to request private certificates that match the value of the actual domains on the final certificate.For example, if you specify
example.com
in theallowed_domains
field, you grant clients the ability to request a certificate that contains the nameexample.com
as one of the DNS values on the final certificate.Important: In some scenarios, allowing bare domains can be considered a security risk. - allow
Glob BooleanDomains - (Boolean) Determines whether to allow glob patterns, for example,
ftp*.example.com
, in the names that are specified in theallowed_domains
field.If set totrue
, clients are allowed to request private certificates with names that match the glob patterns. - allow
Ip BooleanSans - (Boolean) Determines whether to allow clients to request a private certificate with IP Subject Alternative Names.
- allow
Localhost Boolean - (Boolean) Determines whether to allow
localhost
to be included as one of the requested common names. - allow
Subdomains Boolean - (Boolean) Determines whether to allow clients to request private certificates with common names (CN) that are subdomains of the CNs that are allowed by the other certificate template options. This includes wildcard subdomains.For example, if
allowed_domains
has a value ofexample.com
andallow_subdomains
is set totrue
, then the following subdomains are allowed:foo.example.com
,bar.example.com
,*.example.com
.Note: This field is redundant if you use theallow_any_name
option. - allowed
Domains List<String> - (List) The domains to define for the certificate template. This property is used along with the
allow_bare_domains
andallow_subdomains
options.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- allowed
Domains BooleanTemplate - (Boolean) Determines whether to allow the domains that are supplied in the
allowed_domains
field to contain access control list (ACL) templates. - allowed
Other List<String>Sans - (List) The custom Object Identifier (OID) or UTF8-string Subject Alternative Names (SANs) to allow for private certificates.The format for each element in the list is the same as OpenSSL:
<oid>:<type>:<value>
where the current valid type isUTF8
. To allow any value for an OID, use*
as its value. Alternatively, specify a single*
to allow anyother_sans
input.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- allowed
Secret StringGroups - (String) Scopes the creation of private certificates to only the secret groups that you specify.This field can be supplied as a comma-delimited list of secret group IDs.
- Constraints: The maximum length is
1024
characters. The minimum length is2
characters. The value must match regular expression/(.*?)/
.
- Constraints: The maximum length is
- allowed
Uri List<String>Sans - (List) The URI Subject Alternative Names to allow for private certificates.Values can contain glob patterns, for example
spiffe://hostname/_*
.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- basic
Constraints BooleanValid For Non Ca - (Boolean) Determines whether to mark the Basic Constraints extension of an issued private certificate as valid for non-CA certificates.
- String
- (String) The name of the intermediate certificate authority.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- client
Flag Boolean - (Boolean) Determines whether private certificates are flagged for client use.
- code
Signing BooleanFlag - (Boolean) Determines whether private certificates are flagged for code signing use.
- config
Type String - (String) Th configuration type.
- Constraints: Allowable values are:
public_cert_configuration_ca_lets_encrypt
,public_cert_configuration_dns_classic_infrastructure
,public_cert_configuration_dns_cloud_internet_services
,iam_credentials_configuration
,private_cert_configuration_root_ca
,private_cert_configuration_intermediate_ca
,private_cert_configuration_template
.
- Constraints: Allowable values are:
- countries List<String>
- (List) The Country (C) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- created
At String - (String) The date when a resource was created. The date format follows RFC 3339.
- created
By String - (String) The unique identifier that is associated with the entity that created the secret.
- Constraints: The maximum length is
128
characters. The minimum length is4
characters.
- Constraints: The maximum length is
- email
Protection BooleanFlag - (Boolean) Determines whether private certificates are flagged for email protection use.
- enforce
Hostnames Boolean - (Boolean) Determines whether to enforce only valid host names for common names, DNS Subject Alternative Names, and the host section of email addresses.
- ext
Key List<String>Usage Oids - (List) A list of extended key usage Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ext
Key List<String>Usages - (List) The allowed extended key usage constraint on private certificates.You can find valid values in the Go x509 package documentation. Omit the
ExtKeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- id String
- The unique identifier of the data source.
- instance
Id String - key
Bits Double - (Integer) The number of bits to use to generate the private key.Allowable values for RSA keys are:
2048
and4096
. Allowable values for EC keys are:224
,256
,384
, and521
. The default for RSA keys is2048
. The default for EC keys is256
. - key
Type String - (String) The type of private key to generate.
- Constraints: Allowable values are:
rsa
,ec
.
- Constraints: Allowable values are:
- key
Usages List<String> - (List) The allowed key usage constraint to define for private certificates.You can find valid values in the Go x509 package documentation. Omit the
KeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- localities List<String>
- (List) The Locality (L) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- max
Ttl DoubleSeconds - (Integer) The maximum time-to-live (TTL) for certificates that are created by this CA in seconds.
- name String
- not
Before DoubleDuration Seconds - (Integer) The duration in seconds by which to backdate the
not_before
property of an issued private certificate. - organizations List<String>
- (List) The Organization (O) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ous List<String>
- (List) The Organizational Unit (OU) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- policy
Identifiers List<String> - (List) A list of policy Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- postal
Codes List<String> - (List) The postal code values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- provinces List<String>
- (List) The Province (ST) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- region String
- require
Cn Boolean - (Boolean) Determines whether to require a common name to create a private certificate.By default, a common name is required to generate a certificate. To make the
common_name
field optional, set therequire_cn
option tofalse
. - secret
Type String - (String) The secret type. Supported types are arbitrary, certificates (imported, public, and private), IAM credentials, key-value, and user credentials.
- Constraints: Allowable values are:
arbitrary
,imported_cert
,public_cert
,iam_credentials
,kv
,username_password
,private_cert
.
- Constraints: Allowable values are:
- serial
Number String - (String) The serial number to assign to the generated certificate. To assign a random serial number, you can omit this field.
- Constraints: The maximum length is
64
characters. The minimum length is32
characters. The value must match regular expression/[^a-fA-F0-9]/
.
- Constraints: The maximum length is
- server
Flag Boolean - (Boolean) Determines whether private certificates are flagged for server use.
- street
Addresses List<String> - (List) The street address values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ttl
Seconds Double - (Integer) The requested Time To Live, after which the certificate will be expired.
- updated
At String - (String) The date when a resource was recently modified. The date format follows RFC 3339.
- use
Csr BooleanCommon Name - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the common name (CN) from a certificate signing request (CSR) instead of the CN that's included in the data of the certificate.Does not include any requested Subject Alternative Names (SANs) in the CSR. To use the alternative names, include theuse_csr_sans
property. - use
Csr BooleanSans - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the Subject Alternative Names(SANs) from a certificate signing request (CSR) instead of the SANs that are included in the data of the certificate.Does not include the common name in the CSR. To use the common name, include theuse_csr_common_name
property. - endpoint
Type String
- allow
Any booleanName - (Boolean) Determines whether to allow clients to request a private certificate that matches any common name.
- allow
Bare booleanDomains - (Boolean) Determines whether to allow clients to request private certificates that match the value of the actual domains on the final certificate.For example, if you specify
example.com
in theallowed_domains
field, you grant clients the ability to request a certificate that contains the nameexample.com
as one of the DNS values on the final certificate.Important: In some scenarios, allowing bare domains can be considered a security risk. - allow
Glob booleanDomains - (Boolean) Determines whether to allow glob patterns, for example,
ftp*.example.com
, in the names that are specified in theallowed_domains
field.If set totrue
, clients are allowed to request private certificates with names that match the glob patterns. - allow
Ip booleanSans - (Boolean) Determines whether to allow clients to request a private certificate with IP Subject Alternative Names.
- allow
Localhost boolean - (Boolean) Determines whether to allow
localhost
to be included as one of the requested common names. - allow
Subdomains boolean - (Boolean) Determines whether to allow clients to request private certificates with common names (CN) that are subdomains of the CNs that are allowed by the other certificate template options. This includes wildcard subdomains.For example, if
allowed_domains
has a value ofexample.com
andallow_subdomains
is set totrue
, then the following subdomains are allowed:foo.example.com
,bar.example.com
,*.example.com
.Note: This field is redundant if you use theallow_any_name
option. - allowed
Domains string[] - (List) The domains to define for the certificate template. This property is used along with the
allow_bare_domains
andallow_subdomains
options.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- allowed
Domains booleanTemplate - (Boolean) Determines whether to allow the domains that are supplied in the
allowed_domains
field to contain access control list (ACL) templates. - allowed
Other string[]Sans - (List) The custom Object Identifier (OID) or UTF8-string Subject Alternative Names (SANs) to allow for private certificates.The format for each element in the list is the same as OpenSSL:
<oid>:<type>:<value>
where the current valid type isUTF8
. To allow any value for an OID, use*
as its value. Alternatively, specify a single*
to allow anyother_sans
input.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- allowed
Secret stringGroups - (String) Scopes the creation of private certificates to only the secret groups that you specify.This field can be supplied as a comma-delimited list of secret group IDs.
- Constraints: The maximum length is
1024
characters. The minimum length is2
characters. The value must match regular expression/(.*?)/
.
- Constraints: The maximum length is
- allowed
Uri string[]Sans - (List) The URI Subject Alternative Names to allow for private certificates.Values can contain glob patterns, for example
spiffe://hostname/_*
.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- basic
Constraints booleanValid For Non Ca - (Boolean) Determines whether to mark the Basic Constraints extension of an issued private certificate as valid for non-CA certificates.
- string
- (String) The name of the intermediate certificate authority.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- client
Flag boolean - (Boolean) Determines whether private certificates are flagged for client use.
- code
Signing booleanFlag - (Boolean) Determines whether private certificates are flagged for code signing use.
- config
Type string - (String) Th configuration type.
- Constraints: Allowable values are:
public_cert_configuration_ca_lets_encrypt
,public_cert_configuration_dns_classic_infrastructure
,public_cert_configuration_dns_cloud_internet_services
,iam_credentials_configuration
,private_cert_configuration_root_ca
,private_cert_configuration_intermediate_ca
,private_cert_configuration_template
.
- Constraints: Allowable values are:
- countries string[]
- (List) The Country (C) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- created
At string - (String) The date when a resource was created. The date format follows RFC 3339.
- created
By string - (String) The unique identifier that is associated with the entity that created the secret.
- Constraints: The maximum length is
128
characters. The minimum length is4
characters.
- Constraints: The maximum length is
- email
Protection booleanFlag - (Boolean) Determines whether private certificates are flagged for email protection use.
- enforce
Hostnames boolean - (Boolean) Determines whether to enforce only valid host names for common names, DNS Subject Alternative Names, and the host section of email addresses.
- ext
Key string[]Usage Oids - (List) A list of extended key usage Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ext
Key string[]Usages - (List) The allowed extended key usage constraint on private certificates.You can find valid values in the Go x509 package documentation. Omit the
ExtKeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- id string
- The unique identifier of the data source.
- instance
Id string - key
Bits number - (Integer) The number of bits to use to generate the private key.Allowable values for RSA keys are:
2048
and4096
. Allowable values for EC keys are:224
,256
,384
, and521
. The default for RSA keys is2048
. The default for EC keys is256
. - key
Type string - (String) The type of private key to generate.
- Constraints: Allowable values are:
rsa
,ec
.
- Constraints: Allowable values are:
- key
Usages string[] - (List) The allowed key usage constraint to define for private certificates.You can find valid values in the Go x509 package documentation. Omit the
KeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- localities string[]
- (List) The Locality (L) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- max
Ttl numberSeconds - (Integer) The maximum time-to-live (TTL) for certificates that are created by this CA in seconds.
- name string
- not
Before numberDuration Seconds - (Integer) The duration in seconds by which to backdate the
not_before
property of an issued private certificate. - organizations string[]
- (List) The Organization (O) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ous string[]
- (List) The Organizational Unit (OU) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- policy
Identifiers string[] - (List) A list of policy Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- postal
Codes string[] - (List) The postal code values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- provinces string[]
- (List) The Province (ST) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- region string
- require
Cn boolean - (Boolean) Determines whether to require a common name to create a private certificate.By default, a common name is required to generate a certificate. To make the
common_name
field optional, set therequire_cn
option tofalse
. - secret
Type string - (String) The secret type. Supported types are arbitrary, certificates (imported, public, and private), IAM credentials, key-value, and user credentials.
- Constraints: Allowable values are:
arbitrary
,imported_cert
,public_cert
,iam_credentials
,kv
,username_password
,private_cert
.
- Constraints: Allowable values are:
- serial
Number string - (String) The serial number to assign to the generated certificate. To assign a random serial number, you can omit this field.
- Constraints: The maximum length is
64
characters. The minimum length is32
characters. The value must match regular expression/[^a-fA-F0-9]/
.
- Constraints: The maximum length is
- server
Flag boolean - (Boolean) Determines whether private certificates are flagged for server use.
- street
Addresses string[] - (List) The street address values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ttl
Seconds number - (Integer) The requested Time To Live, after which the certificate will be expired.
- updated
At string - (String) The date when a resource was recently modified. The date format follows RFC 3339.
- use
Csr booleanCommon Name - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the common name (CN) from a certificate signing request (CSR) instead of the CN that's included in the data of the certificate.Does not include any requested Subject Alternative Names (SANs) in the CSR. To use the alternative names, include theuse_csr_sans
property. - use
Csr booleanSans - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the Subject Alternative Names(SANs) from a certificate signing request (CSR) instead of the SANs that are included in the data of the certificate.Does not include the common name in the CSR. To use the common name, include theuse_csr_common_name
property. - endpoint
Type string
- allow_
any_ boolname - (Boolean) Determines whether to allow clients to request a private certificate that matches any common name.
- allow_
bare_ booldomains - (Boolean) Determines whether to allow clients to request private certificates that match the value of the actual domains on the final certificate.For example, if you specify
example.com
in theallowed_domains
field, you grant clients the ability to request a certificate that contains the nameexample.com
as one of the DNS values on the final certificate.Important: In some scenarios, allowing bare domains can be considered a security risk. - allow_
glob_ booldomains - (Boolean) Determines whether to allow glob patterns, for example,
ftp*.example.com
, in the names that are specified in theallowed_domains
field.If set totrue
, clients are allowed to request private certificates with names that match the glob patterns. - allow_
ip_ boolsans - (Boolean) Determines whether to allow clients to request a private certificate with IP Subject Alternative Names.
- allow_
localhost bool - (Boolean) Determines whether to allow
localhost
to be included as one of the requested common names. - allow_
subdomains bool - (Boolean) Determines whether to allow clients to request private certificates with common names (CN) that are subdomains of the CNs that are allowed by the other certificate template options. This includes wildcard subdomains.For example, if
allowed_domains
has a value ofexample.com
andallow_subdomains
is set totrue
, then the following subdomains are allowed:foo.example.com
,bar.example.com
,*.example.com
.Note: This field is redundant if you use theallow_any_name
option. - allowed_
domains Sequence[str] - (List) The domains to define for the certificate template. This property is used along with the
allow_bare_domains
andallow_subdomains
options.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- allowed_
domains_ booltemplate - (Boolean) Determines whether to allow the domains that are supplied in the
allowed_domains
field to contain access control list (ACL) templates. - allowed_
other_ Sequence[str]sans - (List) The custom Object Identifier (OID) or UTF8-string Subject Alternative Names (SANs) to allow for private certificates.The format for each element in the list is the same as OpenSSL:
<oid>:<type>:<value>
where the current valid type isUTF8
. To allow any value for an OID, use*
as its value. Alternatively, specify a single*
to allow anyother_sans
input.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- allowed_
secret_ strgroups - (String) Scopes the creation of private certificates to only the secret groups that you specify.This field can be supplied as a comma-delimited list of secret group IDs.
- Constraints: The maximum length is
1024
characters. The minimum length is2
characters. The value must match regular expression/(.*?)/
.
- Constraints: The maximum length is
- allowed_
uri_ Sequence[str]sans - (List) The URI Subject Alternative Names to allow for private certificates.Values can contain glob patterns, for example
spiffe://hostname/_*
.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- basic_
constraints_ boolvalid_ for_ non_ ca - (Boolean) Determines whether to mark the Basic Constraints extension of an issued private certificate as valid for non-CA certificates.
- str
- (String) The name of the intermediate certificate authority.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- client_
flag bool - (Boolean) Determines whether private certificates are flagged for client use.
- code_
signing_ boolflag - (Boolean) Determines whether private certificates are flagged for code signing use.
- config_
type str - (String) Th configuration type.
- Constraints: Allowable values are:
public_cert_configuration_ca_lets_encrypt
,public_cert_configuration_dns_classic_infrastructure
,public_cert_configuration_dns_cloud_internet_services
,iam_credentials_configuration
,private_cert_configuration_root_ca
,private_cert_configuration_intermediate_ca
,private_cert_configuration_template
.
- Constraints: Allowable values are:
- countries Sequence[str]
- (List) The Country (C) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- created_
at str - (String) The date when a resource was created. The date format follows RFC 3339.
- created_
by str - (String) The unique identifier that is associated with the entity that created the secret.
- Constraints: The maximum length is
128
characters. The minimum length is4
characters.
- Constraints: The maximum length is
- email_
protection_ boolflag - (Boolean) Determines whether private certificates are flagged for email protection use.
- enforce_
hostnames bool - (Boolean) Determines whether to enforce only valid host names for common names, DNS Subject Alternative Names, and the host section of email addresses.
- ext_
key_ Sequence[str]usage_ oids - (List) A list of extended key usage Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ext_
key_ Sequence[str]usages - (List) The allowed extended key usage constraint on private certificates.You can find valid values in the Go x509 package documentation. Omit the
ExtKeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- id str
- The unique identifier of the data source.
- instance_
id str - key_
bits float - (Integer) The number of bits to use to generate the private key.Allowable values for RSA keys are:
2048
and4096
. Allowable values for EC keys are:224
,256
,384
, and521
. The default for RSA keys is2048
. The default for EC keys is256
. - key_
type str - (String) The type of private key to generate.
- Constraints: Allowable values are:
rsa
,ec
.
- Constraints: Allowable values are:
- key_
usages Sequence[str] - (List) The allowed key usage constraint to define for private certificates.You can find valid values in the Go x509 package documentation. Omit the
KeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- localities Sequence[str]
- (List) The Locality (L) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- max_
ttl_ floatseconds - (Integer) The maximum time-to-live (TTL) for certificates that are created by this CA in seconds.
- name str
- not_
before_ floatduration_ seconds - (Integer) The duration in seconds by which to backdate the
not_before
property of an issued private certificate. - organizations Sequence[str]
- (List) The Organization (O) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ous Sequence[str]
- (List) The Organizational Unit (OU) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- policy_
identifiers Sequence[str] - (List) A list of policy Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- postal_
codes Sequence[str] - (List) The postal code values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- provinces Sequence[str]
- (List) The Province (ST) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- region str
- require_
cn bool - (Boolean) Determines whether to require a common name to create a private certificate.By default, a common name is required to generate a certificate. To make the
common_name
field optional, set therequire_cn
option tofalse
. - secret_
type str - (String) The secret type. Supported types are arbitrary, certificates (imported, public, and private), IAM credentials, key-value, and user credentials.
- Constraints: Allowable values are:
arbitrary
,imported_cert
,public_cert
,iam_credentials
,kv
,username_password
,private_cert
.
- Constraints: Allowable values are:
- serial_
number str - (String) The serial number to assign to the generated certificate. To assign a random serial number, you can omit this field.
- Constraints: The maximum length is
64
characters. The minimum length is32
characters. The value must match regular expression/[^a-fA-F0-9]/
.
- Constraints: The maximum length is
- server_
flag bool - (Boolean) Determines whether private certificates are flagged for server use.
- street_
addresses Sequence[str] - (List) The street address values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ttl_
seconds float - (Integer) The requested Time To Live, after which the certificate will be expired.
- updated_
at str - (String) The date when a resource was recently modified. The date format follows RFC 3339.
- use_
csr_ boolcommon_ name - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the common name (CN) from a certificate signing request (CSR) instead of the CN that's included in the data of the certificate.Does not include any requested Subject Alternative Names (SANs) in the CSR. To use the alternative names, include theuse_csr_sans
property. - use_
csr_ boolsans - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the Subject Alternative Names(SANs) from a certificate signing request (CSR) instead of the SANs that are included in the data of the certificate.Does not include the common name in the CSR. To use the common name, include theuse_csr_common_name
property. - endpoint_
type str
- allow
Any BooleanName - (Boolean) Determines whether to allow clients to request a private certificate that matches any common name.
- allow
Bare BooleanDomains - (Boolean) Determines whether to allow clients to request private certificates that match the value of the actual domains on the final certificate.For example, if you specify
example.com
in theallowed_domains
field, you grant clients the ability to request a certificate that contains the nameexample.com
as one of the DNS values on the final certificate.Important: In some scenarios, allowing bare domains can be considered a security risk. - allow
Glob BooleanDomains - (Boolean) Determines whether to allow glob patterns, for example,
ftp*.example.com
, in the names that are specified in theallowed_domains
field.If set totrue
, clients are allowed to request private certificates with names that match the glob patterns. - allow
Ip BooleanSans - (Boolean) Determines whether to allow clients to request a private certificate with IP Subject Alternative Names.
- allow
Localhost Boolean - (Boolean) Determines whether to allow
localhost
to be included as one of the requested common names. - allow
Subdomains Boolean - (Boolean) Determines whether to allow clients to request private certificates with common names (CN) that are subdomains of the CNs that are allowed by the other certificate template options. This includes wildcard subdomains.For example, if
allowed_domains
has a value ofexample.com
andallow_subdomains
is set totrue
, then the following subdomains are allowed:foo.example.com
,bar.example.com
,*.example.com
.Note: This field is redundant if you use theallow_any_name
option. - allowed
Domains List<String> - (List) The domains to define for the certificate template. This property is used along with the
allow_bare_domains
andallow_subdomains
options.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- allowed
Domains BooleanTemplate - (Boolean) Determines whether to allow the domains that are supplied in the
allowed_domains
field to contain access control list (ACL) templates. - allowed
Other List<String>Sans - (List) The custom Object Identifier (OID) or UTF8-string Subject Alternative Names (SANs) to allow for private certificates.The format for each element in the list is the same as OpenSSL:
<oid>:<type>:<value>
where the current valid type isUTF8
. To allow any value for an OID, use*
as its value. Alternatively, specify a single*
to allow anyother_sans
input.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- allowed
Secret StringGroups - (String) Scopes the creation of private certificates to only the secret groups that you specify.This field can be supplied as a comma-delimited list of secret group IDs.
- Constraints: The maximum length is
1024
characters. The minimum length is2
characters. The value must match regular expression/(.*?)/
.
- Constraints: The maximum length is
- allowed
Uri List<String>Sans - (List) The URI Subject Alternative Names to allow for private certificates.Values can contain glob patterns, for example
spiffe://hostname/_*
.- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- basic
Constraints BooleanValid For Non Ca - (Boolean) Determines whether to mark the Basic Constraints extension of an issued private certificate as valid for non-CA certificates.
- String
- (String) The name of the intermediate certificate authority.
- Constraints: The maximum length is
128
characters. The minimum length is2
characters. The value must match regular expression/^[A-Za-z0-9][A-Za-z0-9]*(?:_?-?\\.?[A-Za-z0-9]+)*$/
.
- Constraints: The maximum length is
- client
Flag Boolean - (Boolean) Determines whether private certificates are flagged for client use.
- code
Signing BooleanFlag - (Boolean) Determines whether private certificates are flagged for code signing use.
- config
Type String - (String) Th configuration type.
- Constraints: Allowable values are:
public_cert_configuration_ca_lets_encrypt
,public_cert_configuration_dns_classic_infrastructure
,public_cert_configuration_dns_cloud_internet_services
,iam_credentials_configuration
,private_cert_configuration_root_ca
,private_cert_configuration_intermediate_ca
,private_cert_configuration_template
.
- Constraints: Allowable values are:
- countries List<String>
- (List) The Country (C) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- created
At String - (String) The date when a resource was created. The date format follows RFC 3339.
- created
By String - (String) The unique identifier that is associated with the entity that created the secret.
- Constraints: The maximum length is
128
characters. The minimum length is4
characters.
- Constraints: The maximum length is
- email
Protection BooleanFlag - (Boolean) Determines whether private certificates are flagged for email protection use.
- enforce
Hostnames Boolean - (Boolean) Determines whether to enforce only valid host names for common names, DNS Subject Alternative Names, and the host section of email addresses.
- ext
Key List<String>Usage Oids - (List) A list of extended key usage Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ext
Key List<String>Usages - (List) The allowed extended key usage constraint on private certificates.You can find valid values in the Go x509 package documentation. Omit the
ExtKeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- id String
- The unique identifier of the data source.
- instance
Id String - key
Bits Number - (Integer) The number of bits to use to generate the private key.Allowable values for RSA keys are:
2048
and4096
. Allowable values for EC keys are:224
,256
,384
, and521
. The default for RSA keys is2048
. The default for EC keys is256
. - key
Type String - (String) The type of private key to generate.
- Constraints: Allowable values are:
rsa
,ec
.
- Constraints: Allowable values are:
- key
Usages List<String> - (List) The allowed key usage constraint to define for private certificates.You can find valid values in the Go x509 package documentation. Omit the
KeyUsage
part of the value. Values are not case-sensitive. To specify no key usage constraints, set this field to an empty list.- Constraints: The list items must match regular expression
/^[a-zA-Z]+$/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- localities List<String>
- (List) The Locality (L) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- max
Ttl NumberSeconds - (Integer) The maximum time-to-live (TTL) for certificates that are created by this CA in seconds.
- name String
- not
Before NumberDuration Seconds - (Integer) The duration in seconds by which to backdate the
not_before
property of an issued private certificate. - organizations List<String>
- (List) The Organization (O) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ous List<String>
- (List) The Organizational Unit (OU) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- policy
Identifiers List<String> - (List) A list of policy Object Identifiers (OIDs).
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is100
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- postal
Codes List<String> - (List) The postal code values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- provinces List<String>
- (List) The Province (ST) values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- region String
- require
Cn Boolean - (Boolean) Determines whether to require a common name to create a private certificate.By default, a common name is required to generate a certificate. To make the
common_name
field optional, set therequire_cn
option tofalse
. - secret
Type String - (String) The secret type. Supported types are arbitrary, certificates (imported, public, and private), IAM credentials, key-value, and user credentials.
- Constraints: Allowable values are:
arbitrary
,imported_cert
,public_cert
,iam_credentials
,kv
,username_password
,private_cert
.
- Constraints: Allowable values are:
- serial
Number String - (String) The serial number to assign to the generated certificate. To assign a random serial number, you can omit this field.
- Constraints: The maximum length is
64
characters. The minimum length is32
characters. The value must match regular expression/[^a-fA-F0-9]/
.
- Constraints: The maximum length is
- server
Flag Boolean - (Boolean) Determines whether private certificates are flagged for server use.
- street
Addresses List<String> - (List) The street address values to define in the subject field of the resulting certificate.
- Constraints: The list items must match regular expression
/(.*?)/
. The maximum length is10
items. The minimum length is0
items.
- Constraints: The list items must match regular expression
- ttl
Seconds Number - (Integer) The requested Time To Live, after which the certificate will be expired.
- updated
At String - (String) The date when a resource was recently modified. The date format follows RFC 3339.
- use
Csr BooleanCommon Name - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the common name (CN) from a certificate signing request (CSR) instead of the CN that's included in the data of the certificate.Does not include any requested Subject Alternative Names (SANs) in the CSR. To use the alternative names, include theuse_csr_sans
property. - use
Csr BooleanSans - (Boolean) When used with the
private_cert_configuration_action_sign_csr
action, this field determines whether to use the Subject Alternative Names(SANs) from a certificate signing request (CSR) instead of the SANs that are included in the data of the certificate.Does not include the common name in the CSR. To use the common name, include theuse_csr_common_name
property. - endpoint
Type String
Package Details
- Repository
- ibm ibm-cloud/terraform-provider-ibm
- License
- Notes
- This Pulumi package is based on the
ibm
Terraform Provider.