Skip to main content
Server path: /ngrok-certificates | Type: Application | PCID required: Yes

Tools

ToolDescription
ngrok_certificates_certificate_authorities_createCreate
ngrok_certificates_certificate_authorities_deleteDelete
ngrok_certificates_certificate_authorities_getGet
ngrok_certificates_certificate_authorities_listList
ngrok_certificates_certificate_authorities_updateUpdate
ngrok_certificates_ssh_certificate_authorities_createCreate
ngrok_certificates_ssh_certificate_authorities_deleteDelete
ngrok_certificates_ssh_certificate_authorities_getGet
ngrok_certificates_ssh_certificate_authorities_listList
ngrok_certificates_ssh_certificate_authorities_updateUpdate
ngrok_certificates_ssh_credentials_createCreate
ngrok_certificates_ssh_credentials_deleteDelete
ngrok_certificates_ssh_credentials_getGet
ngrok_certificates_ssh_credentials_listList
ngrok_certificates_ssh_credentials_updateUpdate
ngrok_certificates_ssh_host_certificates_createCreate
ngrok_certificates_ssh_host_certificates_deleteDelete
ngrok_certificates_ssh_host_certificates_getGet
ngrok_certificates_ssh_host_certificates_listList
ngrok_certificates_ssh_host_certificates_updateUpdate
ngrok_certificates_ssh_user_certificates_createCreate
ngrok_certificates_ssh_user_certificates_deleteDelete
ngrok_certificates_ssh_user_certificates_getGet
ngrok_certificates_ssh_user_certificates_listList
ngrok_certificates_ssh_user_certificates_updateUpdate
ngrok_certificates_tls_certificates_createCreate
ngrok_certificates_tls_certificates_deleteDelete
ngrok_certificates_tls_certificates_getGet
ngrok_certificates_tls_certificates_listList
ngrok_certificates_tls_certificates_updateUpdate

ngrok_certificates_certificate_authorities_create

Create Parameters:
ParameterTypeRequiredDefaultDescription
ca_pemstringYesraw PEM of the Certificate Authority
descriptionstringNohuman-readable description of this Certificate Authority. optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.

ngrok_certificates_certificate_authorities_delete

Delete Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_certificate_authorities_get

Get Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_certificate_authorities_list

List Parameters:
ParameterTypeRequiredDefaultDescription
before_idstringNoExpects a resource ID as its input. Returns earlier entries in the result set, sorted by ID.
limitstringNoConstrains the number of results in the dataset. See the API Overview for details.
filterstringNoA CEL expression to filter the list results. Supports logical and comparison operators to match on fields such as id, metadata, created_at, and more. See ngrok API Filtering for syntax and field details: https://ngrok.com/docs/api/api-filtering.

ngrok_certificates_certificate_authorities_update

Update Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id value
descriptionstringNohuman-readable description of this Certificate Authority. optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.

ngrok_certificates_ssh_certificate_authorities_create

Create Parameters:
ParameterTypeRequiredDefaultDescription
descriptionstringNohuman-readable description of this SSH Certificate Authority. optional, max 255 bytes.
elliptic_curvestringNothe type of elliptic curve to use when creating an ECDSA key
key_sizeintegerNothe key size to use when creating an RSA key. one of 2048 or 4096
metadatastringNoarbitrary user-defined machine-readable data of this SSH Certificate Authority. optional, max 4096 bytes.
private_key_typestringNothe type of private key to generate. one of rsa, ecdsa, ed25519

ngrok_certificates_ssh_certificate_authorities_delete

Delete Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_ssh_certificate_authorities_get

Get Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_ssh_certificate_authorities_list

List Parameters:
ParameterTypeRequiredDefaultDescription
before_idstringNoExpects a resource ID as its input. Returns earlier entries in the result set, sorted by ID.
limitstringNoConstrains the number of results in the dataset. See the API Overview for details.
filterstringNoA CEL expression to filter the list results. Supports logical and comparison operators to match on fields such as id, metadata, created_at, and more. See ngrok API Filtering for syntax and field details: https://ngrok.com/docs/api/api-filtering.

ngrok_certificates_ssh_certificate_authorities_update

Update Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id value
descriptionstringNohuman-readable description of this SSH Certificate Authority. optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this SSH Certificate Authority. optional, max 4096 bytes.

ngrok_certificates_ssh_credentials_create

Create Parameters:
ParameterTypeRequiredDefaultDescription
aclstring[]Nooptional list of ACL rules. If unspecified, the credential will have no restrictions. The only allowed ACL rule at this time is the bind rule. The bind rule allows the caller to restrict what domains, addresses, and labels the token is allowed to bind. For example, to allow the token to open a tunnel on example.ngrok.io your ACL would include the rule bind:example.ngrok.io. Bind rules for domains may specify a leading wildcard to match multiple domains with a common suffix. For example, you may specify a rule of bind:*.example.com which will allow x.example.com, y.example.com, *.example.com, etc. Bind rules for labels may specify a wildcard key and/or value to match multiple labels. For example, you may specify a rule of bind:*=example which will allow x=example, y=example, etc. A rule of '*' is equivalent to no acl at all and will explicitly permit all actions.
descriptionstringNohuman-readable description of who or what will use the ssh credential to authenticate. Optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this ssh credential. Optional, max 4096 bytes.
owner_idstringNoIf supplied at credential creation, ownership will be assigned to the specified User or Bot. Only admins may specify an owner other than themselves. Defaults to the authenticated User or Bot.
public_keystringYesthe PEM-encoded public key of the SSH keypair that will be used to authenticate

ngrok_certificates_ssh_credentials_delete

Delete Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_ssh_credentials_get

Get Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_ssh_credentials_list

List Parameters:
ParameterTypeRequiredDefaultDescription
before_idstringNoExpects a resource ID as its input. Returns earlier entries in the result set, sorted by ID.
limitstringNoConstrains the number of results in the dataset. See the API Overview for details.
filterstringNoA CEL expression to filter the list results. Supports logical and comparison operators to match on fields such as id, metadata, created_at, and more. See ngrok API Filtering for syntax and field details: https://ngrok.com/docs/api/api-filtering.

ngrok_certificates_ssh_credentials_update

Update Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id value
aclstring[]Nooptional list of ACL rules. If unspecified, the credential will have no restrictions. The only allowed ACL rule at this time is the bind rule. The bind rule allows the caller to restrict what domains, addresses, and labels the token is allowed to bind. For example, to allow the token to open a tunnel on example.ngrok.io your ACL would include the rule bind:example.ngrok.io. Bind rules for domains may specify a leading wildcard to match multiple domains with a common suffix. For example, you may specify a rule of bind:*.example.com which will allow x.example.com, y.example.com, *.example.com, etc. Bind rules for labels may specify a wildcard key and/or value to match multiple labels. For example, you may specify a rule of bind:*=example which will allow x=example, y=example, etc. A rule of '*' is equivalent to no acl at all and will explicitly permit all actions.
descriptionstringNohuman-readable description of who or what will use the ssh credential to authenticate. Optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this ssh credential. Optional, max 4096 bytes.

ngrok_certificates_ssh_host_certificates_create

Create Parameters:
ParameterTypeRequiredDefaultDescription
descriptionstringNohuman-readable description of this SSH Host Certificate. optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this SSH Host Certificate. optional, max 4096 bytes.
principalsstring[]Nothe list of principals included in the ssh host certificate. This is the list of hostnames and/or IP addresses that are authorized to serve SSH traffic with this certificate. Dangerously, if no principals are specified, this certificate is considered valid for all hosts.
public_keystringYesa public key in OpenSSH Authorized Keys format that this certificate signs
ssh_certificate_authority_idstringYesthe ssh certificate authority that is used to sign this ssh host certificate
valid_afterstringNoThe time when the host certificate becomes valid, in RFC 3339 format. Defaults to the current time if unspecified.
valid_untilstringNoThe time when this host certificate becomes invalid, in RFC 3339 format. If unspecified, a default value of one year in the future will be used. The OpenSSH certificates RFC calls this valid_before.

ngrok_certificates_ssh_host_certificates_delete

Delete Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_ssh_host_certificates_get

Get Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_ssh_host_certificates_list

List Parameters:
ParameterTypeRequiredDefaultDescription
before_idstringNoBefore Id
limitstringNoMaximum number of results to return

ngrok_certificates_ssh_host_certificates_update

Update Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id value
descriptionstringNohuman-readable description of this SSH Host Certificate. optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this SSH Host Certificate. optional, max 4096 bytes.

ngrok_certificates_ssh_user_certificates_create

Create Parameters:
ParameterTypeRequiredDefaultDescription
critical_optionsobjectNoA map of critical options included in the certificate. Only two critical options are currently defined by OpenSSH: force-command and source-address. See the OpenSSH certificate protocol spec for additional details.
descriptionstringNohuman-readable description of this SSH User Certificate. optional, max 255 bytes.
extensionsobjectNoA map of extensions included in the certificate. Extensions are additional metadata that can be interpreted by the SSH server for any purpose. These can be used to permit or deny the ability to open a terminal, do port forwarding, x11 forwarding, and more. If unspecified, the certificate will include limited permissions with the following extension map: {"permit-pty": "", "permit-user-rc": ""} OpenSSH understands a number of predefined extensions. See the OpenSSH certificate protocol spec for additional details.
metadatastringNoarbitrary user-defined machine-readable data of this SSH User Certificate. optional, max 4096 bytes.
principalsstring[]Nothe list of principals included in the ssh user certificate. This is the list of usernames that the certificate holder may sign in as on a machine authorizing the signing certificate authority. Dangerously, if no principals are specified, this certificate may be used to log in as any user.
public_keystringYesa public key in OpenSSH Authorized Keys format that this certificate signs
ssh_certificate_authority_idstringYesthe ssh certificate authority that is used to sign this ssh user certificate
valid_afterstringNoThe time when the user certificate becomes valid, in RFC 3339 format. Defaults to the current time if unspecified.
valid_untilstringNoThe time when this host certificate becomes invalid, in RFC 3339 format. If unspecified, a default value of 24 hours will be used. The OpenSSH certificates RFC calls this valid_before.

ngrok_certificates_ssh_user_certificates_delete

Delete Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_ssh_user_certificates_get

Get Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_ssh_user_certificates_list

List Parameters:
ParameterTypeRequiredDefaultDescription
before_idstringNoBefore Id
limitstringNoMaximum number of results to return

ngrok_certificates_ssh_user_certificates_update

Update Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id value
descriptionstringNohuman-readable description of this SSH User Certificate. optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this SSH User Certificate. optional, max 4096 bytes.

ngrok_certificates_tls_certificates_create

Create Parameters:
ParameterTypeRequiredDefaultDescription
certificate_pemstringYeschain of PEM-encoded certificates, leaf first. See Certificate Bundles.
descriptionstringNohuman-readable description of this TLS certificate. optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this TLS certificate. optional, max 4096 bytes.
private_key_pemstringYesprivate key for the TLS certificate, PEM-encoded. See Private Keys.

ngrok_certificates_tls_certificates_delete

Delete Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_tls_certificates_get

Get Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesa resource identifier

ngrok_certificates_tls_certificates_list

List Parameters:
ParameterTypeRequiredDefaultDescription
before_idstringNoExpects a resource ID as its input. Returns earlier entries in the result set, sorted by ID.
limitstringNoConstrains the number of results in the dataset. See the API Overview for details.
filterstringNoA CEL expression to filter the list results. Supports logical and comparison operators to match on fields such as id, metadata, created_at, and more. See ngrok API Filtering for syntax and field details: https://ngrok.com/docs/api/api-filtering.

ngrok_certificates_tls_certificates_update

Update Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id value
descriptionstringNohuman-readable description of this TLS certificate. optional, max 255 bytes.
metadatastringNoarbitrary user-defined machine-readable data of this TLS certificate. optional, max 4096 bytes.