Certificate Authorities¶

Do not construct this object directly, instead access the certificate_authorities property of an ngrok.Client object.

class ngrok.services.CertificateAuthoritiesClient(client)[source]¶

Certificate Authorities are x509 certificates that are used to sign other x509 certificates. Attach a Certificate Authority to the Mutual TLS module to verify that the TLS certificate presented by a client has been signed by this CA. Certificate Authorities are used only for mTLS validation only and thus a private key is not included in the resource.

create(ca_pem, description='', metadata='')[source]¶

Upload a new Certificate Authority

Parameters

description (str) – human-readable description of this Certificate Authority. optional, max 255 bytes.
metadata (str) – arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
ca_pem (str) – raw PEM of the Certificate Authority

https://ngrok.com/docs/api#api-certificate-authorities-create

Return type: CertificateAuthority

delete(id)[source]¶

Delete a Certificate Authority

Parameters: id (str) – a resource identifier

https://ngrok.com/docs/api#api-certificate-authorities-delete

get(id)[source]¶

Get detailed information about a certficate authority

Parameters: id (str) – a resource identifier

https://ngrok.com/docs/api#api-certificate-authorities-get

Return type: CertificateAuthority

list(before_id=None, limit=None)[source]¶

List all Certificate Authority on this account

Parameters

before_id (Optional[str]) –
limit (Optional[str]) –

https://ngrok.com/docs/api#api-certificate-authorities-list

Return type: CertificateAuthorityList

update(id, description=None, metadata=None)[source]¶

Update attributes of a Certificate Authority by ID

Parameters

id (str) –
description (Optional[str]) – human-readable description of this Certificate Authority. optional, max 255 bytes.
metadata (Optional[str]) – arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.

https://ngrok.com/docs/api#api-certificate-authorities-update

Return type: CertificateAuthority