Pour connecter un client à une instance ApsaraMQ for Kafka, vous devez disposer de l'endpoint approprié en fonction de votre type de réseau et de vos exigences de sécurité. Cette rubrique décrit les types d'endpoints disponibles et explique comment les trouver dans la console ApsaraMQ for Kafka.
Types d'endpoints
ApsaraMQ for Kafka propose trois types d'endpoints :
| Type d'endpoint | Réseau | Authentification SASL | Chiffrement | Cas d'utilisation |
|---|---|---|---|---|
| Endpoint par défaut | VPC | Non | Non | Messagerie interne au VPC sans authentification au niveau du client |
| Endpoint SASL | VPC | Oui | Non | Messagerie interne au VPC avec authentification au niveau du client |
| Endpoint SSL | Internet | Oui | Oui (TLS) | Messagerie via Internet avec chiffrement et authentification |
Pour une comparaison détaillée, consultez Comparaison des endpoints.
Endpoints affichés selon le type d'instance
Les endpoints disponibles dans la console dépendent de la configuration de votre instance :
| Type d'instance | Endpoints affichés |
|---|---|
| Connectée au VPC | Endpoint par défaut |
| Connectée à Internet et au VPC | Endpoint par défaut, endpoint SSL |
Les endpoints SASL ne sont pas activés par défaut. Pour utiliser les endpoints SASL, activez-les via la fonctionnalité ACL. Pour plus d'informations, consultez Utiliser la fonctionnalité ACL pour le contrôle d'accès.
Format de l'endpoint
Les endpoints utilisent le format suivant :
<Instance domain name>:<Port number>
Les anciennes instances peuvent encore afficher des endpoints au format <Broker IP address>:<Port number>. Pour garantir une stabilité à long terme, migrez vers le format de nom de domaine. Consultez la section « Migrer un ancien endpoint vers le format de nom de domaine » ci-dessous.
Trouver votre endpoint dans la console
Connectez-vous à la console ApsaraMQ for Kafka.
Dans la section Resource Distribution de la page Overview, sélectionnez la région où se trouve votre instance.
Sur la page Instances, cliquez sur le nom de l'instance.
Sur la page Instance Details, cliquez sur l'onglet Instance Information.
Dans la section Endpoint Information, recherchez l'endpoint dans la colonne Domain Name.
Migrer un ancien endpoint vers le format de nom de domaine
Si votre instance utilise toujours l'ancien format <Broker IP address>:<Port number>, migrez vers le format de nom de domaine pour assurer une stabilité à long terme :
Sur la page Instance Details, cliquez sur l'onglet Instance Information.
Dans la section Endpoint Information, cliquez sur Enable Domain Name Feature dans la colonne Actions.
Dans la boîte de dialogue de confirmation Enable Domain Name Feature, cliquez sur Enable.
Recherchez le nouvel endpoint dans la colonne Domain name.
Après la migration, vous pouvez toujours afficher l'endpoint d'origine basé sur l'adresse IP en survolant le nom de domaine.
Connecter un client avec l'endpoint
Une fois que vous avez obtenu l'endpoint, utilisez un SDK pour connecter un client à votre instance ApsaraMQ for Kafka. Pour plus d'informations, consultez Présentation du SDK.
Si votre instance se connecte à un VPC via une liaison dédiée, définissez les adresses d'enregistrement DNS sur 100.100.2.136 et 100.100.2.138 avant d'utiliser un SDK pour accéder à l'instance.