Stay organized with collections
Save and categorize content based on your preferences.
Carriers uses HTTPS (TLS) for transport layer security.
Transport layer encryption with HTTPS
All API endpoints must be served using HTTPS with TLS 1.2 or higher. API
clients must have common name (CN) checking turned on and the server's CN or
wildcards must match the hostname.
We strongly recommend using a certificate issued under a root certificate
included in the
Mozilla CA certification program
to reduce the level of maintenance necessary to keep this connection healthy.
However, if necessary, we do allow partners to issue self-signed certificates
that we can trust.
Cipher suites
The server must support at least one of these cipher suites and should not
support cipher suites outside of the following set:
ECDHE-ECDSA-AES128-GCM-SHA256
ECDHE-RSA-AES128-GCM-SHA256
ECDHE-ECDSA-CHACHA20-POLY1305
ECDHE-RSA-CHACHA20-POLY1305
ECDHE-ECDSA-AES128-SHA256
ECDHE-RSA-AES128-SHA256
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-03 UTC."],[[["\u003cp\u003eAll API endpoints must utilize HTTPS with TLS 1.2 or higher for secure communication.\u003c/p\u003e\n"],["\u003cp\u003eAPI clients must have common name (CN) checking enabled and the server's CN or wildcards must match the hostname to ensure proper authentication.\u003c/p\u003e\n"],["\u003cp\u003eWhile certificates issued under the Mozilla CA certification program are recommended, self-signed certificates are allowed with prior arrangement.\u003c/p\u003e\n"],["\u003cp\u003eServers must support at least one of the specified cipher suites for encryption and should avoid using any outside the provided set for security and compatibility.\u003c/p\u003e\n"]]],["Carriers must use HTTPS with TLS 1.2 or higher for all API endpoints, with common name checking enabled and matching hostnames. Using a certificate from the Mozilla CA program is recommended; self-signed certificates are permitted. If a certificate is revoked, a new one must be obtained immediately. Servers must support at least one of the listed cipher suites (e.g., ECDHE-ECDSA-AES128-GCM-SHA256) and must not support any outside of them.\n"],null,["# Transport layer encryption\n\nCarriers uses HTTPS (TLS) for transport layer security.\n\nTransport layer encryption with HTTPS\n-------------------------------------\n\nAll API endpoints must be served using HTTPS with TLS 1.2 or higher. API\nclients must have common name (CN) checking turned on and the server's CN or\nwildcards must match the hostname.\nWe strongly recommend using a certificate issued under a root certificate included in the [Mozilla CA certification program](https://www.mozilla.org/about/governance/policies/security-group/certs/policy/) to reduce the level of maintenance necessary to keep this connection healthy. However, if necessary, we do allow partners to issue self-signed certificates that we can trust. **Note:** If a server's certificate is revoked by the CA, Google will contact you to get a new cert immediately.\n\n### Cipher suites\n\nThe server must support at least one of these cipher suites and should not\nsupport cipher suites outside of the following set:\n\n- ECDHE-ECDSA-AES128-GCM-SHA256\n- ECDHE-RSA-AES128-GCM-SHA256\n- ECDHE-ECDSA-CHACHA20-POLY1305\n- ECDHE-RSA-CHACHA20-POLY1305\n- ECDHE-ECDSA-AES128-SHA256\n- ECDHE-RSA-AES128-SHA256"]]