| title | excerpt | updated |
|---|---|---|
Obtenir les identifiants PPPoE |
Découvrez comment récupérer les identifiants PPPoE de votre accès à Internet OVHcloud via les API |
2023-08-08 |
Si vous souhaitez utiliser votre équipement personnel pour gérer la connexion PPPoE sur votre offre xDSL/FTTH OVHcloud, vous devez récupérer les identifiants PPPoE associés à cet accès.
Les identifiants Point to Point Protocol over Ethernet (PPPoE) sont composés d'un nom d'utilisateur (ID) sous la forme [email protected] et d'un mot de passe unique. Leur fonction est d'authentifier un équipement (équipement personnel ou modem fourni par OVHcloud) sur les infrastructures OVHcloud.
Découvrez comment utiliser les API OVHcloud pour récupérer les identifiants PPPoE d'un accès à Internet.
- Disposer d'un accès Internet xDSL ou FTTH OVHcloud.
- Disposer d'un équipement (routeur, firewall) compatible PPPoE.
- Être connecté à l'espace client OVHcloud.
- Être connecté aux API OVHcloud.
- Consulter le guide Premiers pas avec les API OVHcloud pour vous familiariser avec l'utilisation des APIv6 OVHcloud.
Les identifiants PPPoE vous sont envoyés par e-mail (à l'adresse e-mail de contact de votre compte OVHcloud) pendant la livraison de votre accès.
Ces identifiants vous permettent de configurer le modem OVHcloud, dans le cas d’une configuration manuelle en local, ou un équipement personnel pour l’usage de votre accès à Internet.
Si votre offre a été fournie avec un modem OVHcloud, les identifiants PPPoE vous sont envoyés par e-mail systématiquement après chaque réinitialisation du modem.
Le login reste identique après chaque réinitialisation. Pour des raisons de sécurité, le mot de passe est systématiquement modifié après chaque réinitialisation.
Si vous souhaitez utiliser votre propre modem/routeur, vous pouvez utiliser les API OVHcloud afin de générer l'envoi de nouveaux identifiants PPPoE par e-mail.
Dans un premier temps, il vous faut retrouver le serviceName de votre accès à Internet.
Le serviceName correspond à la référence interne de votre accès. Pour la retrouver, suivez ces étapes :
- Connectez-vous à votre espace client OVHcloud et cliquez sur
Télécom{.action}. - Cliquez sur
Accès Internet{.action} puis sur le Pack contenant l'accès à Internet concerné.
La référence interne est affichée dans le cadre Accès Internet à droite.
{.thumbnail}
Warning
Chaque utilisation de l'appel API décrit ci-dessous générera un nouveau mot de passe PPPoE. Cela aura pour effet de couper la session de votre modem si elle est active, occasionnant une déconnexion. N'utilisez donc cet appel API que si vous êtes certain de pouvoir reconfigurer votre équipement personnel dans la foulée.
Utilisez l'appel API :
[!api]
@api {v1} /xdsl POST /xdsl/{serviceName}/requestPPPLoginMail
Saisissez, dans le champ serviceName, la référence de votre accès obtenue à l'étape précédente. Cliquez alors sur Execute{.action}. Le message null confirmera la bonne prise en compte de votre demande.
Dans un délai approximatif de deux à trois minutes, vous recevrez un e-mail, sur l'adresse e-mail de contact du compte OVHcloud, contenant l'identifiant PPPoE et le nouveau mot de passe.
Si vous n'avez pas accès à l'adresse e-mail de contact du compte OVHcloud, vous pouvez consulter les e-mails de service depuis l'espace client OVHcloud.
Une fois connecté, cliquez sur votre nom puis sur E-mails de service{.action}.
{.thumbnail}
L'objet de l'e-mail est le suivant :
{.thumbnail}
Voici un exemple d'e-mail contenant les identifiants PPPoE :
{.thumbnail}
Vous pouvez suivre le guide « Configurer un routeur manuellement » pour configurer manuellement vos identifiants PPPoE sur votre propre matériel.
Échangez avec notre communauté d'utilisateurs.