Skip to content

Commit 45872f5

Browse files
baywetbaywet
authored
Merge pull request #30 from OfficeGlobal/master
HB of localized readme files
2 parents dfe8040 + 73b8860 commit 45872f5

File tree

6 files changed

+1063
-0
lines changed

6 files changed

+1063
-0
lines changed

‎README-localized/README-es-es.md‎

Lines changed: 177 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,177 @@
1+
---
2+
page_type: sample
3+
products:
4+
- ms-graph
5+
languages:
6+
- nodejs
7+
- javascript
8+
description: "Cree suscripciones de webhook de Microsoft Graph para una aplicación Node.js, para que pueda recibir notificaciones de cambios en los datos de la cuenta de Microsoft de un usuario."
9+
extensions:
10+
contentType: samples
11+
technologies:
12+
- Microsoft Graph
13+
createdDate: 3/9/2016 4:12:18 PM
14+
---
15+
# Ejemplo de webhooks de Microsoft Graph para Node.js
16+
17+
[![Estado de la compilación](https://travis-ci.org/microsoftgraph/nodejs-webhooks-rest-sample.svg)](https://travis-ci.org/microsoftgraph/nodejs-webhooks-rest-sample)
18+
19+
## Tabla de contenido. ##
20+
* [Introducción](#introduction)
21+
22+
* [Capturas de pantalla](#screenshots)
23+
24+
* [Requisitos previos](#prerequisites)
25+
26+
* [Registrar la aplicación](#Register-the-app)
27+
28+
* [Configurar un túnel para el localhost](#Configure-a-tunnel-for-your-localhost)
29+
30+
* [Configurar y ejecutar la aplicación web](#Configure-and-run-the-web-app)
31+
32+
* [Colaboradores](#contributing)
33+
34+
* [Preguntas y comentarios](#Questions-and-Comments)
35+
36+
* [Recursos adicionales](#Additional-resources)
37+
38+
39+
## Introducción
40+
<a name="introduction"></a>
41+
42+
En este ejemplo de Node.js, se muestra cómo empezar a recibir notificaciones de Microsoft Graph. Las tareas comunes que una aplicación web realiza con los webhooks Microsoft Graph.
43+
44+
- Inicie sesión con la cuenta profesional o educativa de los usuarios para obtener un token de acceso.
45+
- Usar el token de acceso para crear una suscripción de webhook.
46+
- Devuelva un token de validación para confirmar la dirección URL de notificación.
47+
- Preste atención a las notificaciones de Microsoft Graph.
48+
- Solicite más información en Microsoft Office 365 usando datos en la notificación.
49+
50+
## Capturas de pantalla
51+
<a name="screenshots"></a>
52+
53+
1. En primer lugar, necesita iniciar sesión.
54+
55+
![iniciar sesión](https://user-images.githubusercontent.com/3375461/31968683-c373ad30-b8c6-11e7-9d01-413fab9fd6d5.png)
56+
57+
1. Una vez que haya iniciado sesión, la aplicación atenderá los correos electrónicos entrantes.
58+
59+
![atender](https://user-images.githubusercontent.com/3375461/31968718-e19696c4-b8c6-11e7-91f2-f1806be0b134.png)
60+
61+
1. Después de enviar el correo electrónico a la dirección, verá el correo electrónico en la aplicación.
62+
63+
![correo electrónico](https://user-images.githubusercontent.com/3375461/31968754-0ce4dafc-b8c7-11e7-8458-8152d598228e.png)
64+
65+
## Requisitos previos
66+
<a name="prerequisites"></a>
67+
68+
Para usar el ejemplo de webhook, necesita lo siguiente:
69+
70+
- [Node.js](https://nodejs.org/) (versión 4 o 5)
71+
- Una [cuenta profesional o educativa](http://dev.office.com/devprogram).
72+
73+
## Registrar la aplicación
74+
<a name="Register-the-app"></a>
75+
76+
Esta aplicación usa el extremo de Azure AD, por lo que puede registrarlo en [Azure Portal](https://ms.portal.azure.com/#blade/Microsoft_AAD_IAM/ApplicationsListBlade).
77+
78+
1. Inicie sesión en Microsoft Azure Portal con una cuenta personal, profesional o educativa de Microsoft.
79+
1. Si su cuenta le da acceso a más de un inquilino, seleccione su cuenta en la esquina superior derecha y establezca su sesión de portal con el inquilino Azure AD deseado (usando cambiar directorio).
80+
1. En el panel de navegación de la izquierda, seleccione el **servicio de Azure Active Directory**, y luego seleccione **registros de aplicaciones.** ![](readme-images/registrations.png)
81+
82+
1. Seleccione **Nuevo registro de aplicaciones**.
83+
84+
1. Escriba un nombre descriptivo para la aplicación.
85+
1. Seleccione “Aplicación web o API” como **Tipo de aplicación**.
86+
1. Escriba `http://localhost:3000/callback` para la **URL de inicio de sesión**.
87+
1. En la sección tipos de cuentas admitidas, seleccione cuentas en cualquier directorio organizacional y cuentas personales de Microsoft (por ejemplo, Skype, Xbox, Outlook.com).
88+
1. Haga clic en **Crear**.
89+
90+
1. Escoja la nueva aplicación de la lista de aplicaciones registradas.
91+
En la página **Información general** de la aplicación, busque el valor **Id. de la aplicación (cliente)** y guárdelo para más tarde.
92+
Lo necesitará para configurar el archivo de configuración de Visual Studio para este proyecto.
93+
![](readme-images/client.png)
94+
1. Configurar los permisos de la aplicación:
95+
96+
1. Seleccione **Configuración** > **Permisos necesarios** > **Agregar**.
97+
1. Escoja **Seleccionar una API** > **Microsoft Graph** y después haga clic en **Seleccionar**.
98+
1. Elija **Seleccionar permisos**, desplácese hasta **Permisos delegados**, elija **Mail.Read** y después haga clic en **Seleccionar**.
99+
1. Haga clic en **Listo**.
100+
![](readme-images/permissions.png)
101+
102+
1. Seleccione **Certificados y secretos** en **Administrar**. Seleccione el botón **Nuevo secreto de cliente**. Escriba un valor en Descripción y seleccione una de las opciones de Expirar y luego seleccione **Agregar**.
103+
104+
![](readme-images/secrets.png)
105+
106+
1. **Importante**: Copie el valor clave: este es el secreto de la aplicación. No podrá volver a obtener acceso a este valor una vez que abandone esta hoja.
107+
108+
Deberá usar el **ID** y el **secreto de aplicación** para configurarla.
109+
110+
## Configurar un túnel para el localhost
111+
112+
El ejemplo usa localhost como servidor de desarrollo. Por este motivo, es necesario un túnel que pueda reenviar las solicitudes de una dirección URL de Internet a su localhost. Si, por algún motivo, no desea usar un túnel, vea [Hosting without a tunnel](https://github.com/OfficeDev/Microsoft-Graph-Nodejs-Webhooks/wiki/Hosting-the-sample-without-a-tunnel) (Hospedar sin un túnel). Si desea obtener una explicación detallada sobre los motivos por los que debe usar un túnel, vea [Why do I have to use a tunnel?](https://github.com/OfficeDev/Microsoft-Graph-Nodejs-Webhooks/wiki/Why-do-I-have-to-use-a-tunnel) (¿Por qué tengo que usar un túnel?)
113+
114+
Para este ejemplo, usamos [ngrok](https://ngrok.com/) para crear el túnel. Para configurar ngrok:
115+
116+
1. [Descargue](https://ngrok.com/download) y descomprima los archivos binarios de ngrok para su plataforma.
117+
1. Escriba el siguiente comando:
118+
119+
```Shell
120+
ngrok http 3000
121+
```
122+
123+
1. Tome nota de la *dirección URL pública https* que ngrok le proporciona. Este es un ejemplo:
124+
125+
```http
126+
https://{NGROK_ID}.ngrok.io
127+
```
128+
129+
Necesitará el valor `NGROK_ID` en la siguiente sección.
130+
131+
## Configurar y ejecutar la aplicación web
132+
133+
1. Use un editor de texto para abrir `constants.js`.
134+
1. Reemplace `ENTER_YOUR_CLIENT_ID` por el identificador de cliente de la aplicación registrada en Azure.
135+
1. Reemplace `ENTER_YOUR_SECRET` con el secreto de cliente de la aplicación registrada en Azure.
136+
1. Reemplace `NGROK_ID` con el valor de *dirección URL https pública* de la sección anterior.
137+
![](const)
138+
1. Instale las dependencias ejecutando el siguiente comando:
139+
140+
```Shell
141+
npm install
142+
```
143+
144+
1. Inicie la aplicación de con el siguiente comando:
145+
146+
```Shell
147+
npm start
148+
```
149+
> **Nota:** También puede hacer que la aplicación espere a un depurador. Para esperar a un depurador, utilice el siguiente comando en su lugar:
150+
>
151+
> ```Shell
152+
> npm run debug
153+
> ```
154+
También puede adjuntar el depurador incluido en Microsoft Visual Studio Code. Para más información, vea [Debugging in Visual Studio Code](https://code.visualstudio.com/Docs/editor/debugging) (Depurar con Visual Studio Code).
155+
156+
1. Abra el explorador y vaya a [http://localhost:3000](http://localhost:3000).
157+
158+
## Colaboradores
159+
160+
Si quiere hacer su aportación a este ejemplo, vea [CONTRIBUTING.MD](/CONTRIBUTING.md).
161+
162+
Este proyecto ha adoptado el [Código de conducta de código abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/). Para obtener más información, vea [Preguntas frecuentes sobre el código de conducta](https://opensource.microsoft.com/codeofconduct/faq/) o póngase en contacto con [[email protected]](mailto:[email protected]) si tiene otras preguntas o comentarios.
163+
164+
## Preguntas y comentarios
165+
166+
Nos encantaría recibir sus comentarios acerca del ejemplo de Webhook de Microsoft Graph. Puede enviarnos sus preguntas y sugerencias a través de la sección [Problemas](https://github.com/OfficeDev/Microsoft-Graph-NodeJs-Webhooks/issues) de este repositorio.
167+
168+
¿Tiene preguntas sobre el desarrollo de Office 365? Publíquelas en [Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API). Asegúrese de etiquetar sus preguntas o comentarios con \[Office365] y \[API].
169+
170+
## Recursos adicionales
171+
172+
- [Información general de Microsoft Graph](http://graph.microsoft.io/)
173+
- [Documentación de referencia de la suscripción](https://graph.microsoft.io/en-us/docs/api-reference/beta/resources/subscription)
174+
175+
## Derechos de autor
176+
177+
Copyright (c) 2019 Microsoft. Todos los derechos reservados.

‎README-localized/README-fr-fr.md‎

Lines changed: 177 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,177 @@
1+
---
2+
page_type: sample
3+
products:
4+
- ms-graph
5+
languages:
6+
- nodejs
7+
- javascript
8+
description: "Créez des abonnements webhook Microsoft Graph pour une application Node.js afin qu’elle puisse recevoir des notifications lorsque des modifications sont apportées aux données de compte Microsoft d’un utilisateur."
9+
extensions:
10+
contentType: samples
11+
technologies:
12+
- Microsoft Graph
13+
createdDate: 3/9/2016 4:12:18 PM
14+
---
15+
# Exemple de webhooks Microsoft Graph pour Node.js
16+
17+
[![État de création](https://travis-ci.org/microsoftgraph/nodejs-webhooks-rest-sample.svg)](https://travis-ci.org/microsoftgraph/nodejs-webhooks-rest-sample)
18+
19+
## Table des matières. ##
20+
* [Introduction](#introduction)
21+
22+
* [Captures d’écran](#screenshots)
23+
24+
* [Conditions préalables](#prerequisites)
25+
26+
* [Inscription de l’application](#Register-the-app)
27+
28+
* [Configurer un tunnel pour votre localhost](#Configure-a-tunnel-for-your-localhost)
29+
30+
* [Configurer et exécuter l’application web](#Configure-and-run-the-web-app)
31+
32+
* [Contribution](#contributing)
33+
34+
* [Questions et commentaires](#Questions-and-Comments)
35+
36+
* [Ressources supplémentaires](#Additional-resources)
37+
38+
39+
## Introduction
40+
<a name="introduction"></a>
41+
42+
Cet exemple Node.js présente comment commencer à recevoir des notifications de Microsoft Graph. Voici les tâches habituelles qu’une application web effectue avec des webhooks Microsoft Graph.
43+
44+
- Connectez vos utilisateurs à l’aide de leur compte professionnel ou scolaire pour l'obtention d'un jeton d’accès.
45+
- Utiliser le jeton d'accès pour créer un abonnement webhook.
46+
- Renvoyez un jeton de validation pour confirmer l'URL de notification.
47+
- Surveillez les notifications provenant de Microsoft Graph.
48+
- Demandez davantage d’informations dans Microsoft Office 365 en utilisant les données de la notification.
49+
50+
## Captures d’écran
51+
<a name="screenshots"></a>
52+
53+
1. Vous devez tout d'abord vous connecter.
54+
55+
![Se connecter](https://user-images.githubusercontent.com/3375461/31968683-c373ad30-b8c6-11e7-9d01-413fab9fd6d5.png)
56+
57+
1. Une fois connecté, l’application observe les messages électroniques entrants.
58+
59+
![observation](https://user-images.githubusercontent.com/3375461/31968718-e19696c4-b8c6-11e7-91f2-f1806be0b134.png)
60+
61+
1. Après envoi de l'e-mail vers l’adresse, celui-ci apparaît dans l’application.
62+
63+
![e-mail](https://user-images.githubusercontent.com/3375461/31968754-0ce4dafc-b8c7-11e7-8458-8152d598228e.png)
64+
65+
## Conditions préalables
66+
<a name="prerequisites"></a>
67+
68+
Pour utiliser l'exemple webhook, l'élément suivant est nécessaire :
69+
70+
- [Node.js](https://nodejs.org/) version 4 ou 5.
71+
- Un [compte professionnel ou scolaire](http://dev.office.com/devprogram).
72+
73+
## Inscription de l’application
74+
<a name="Register-the-app"></a>
75+
76+
Cette application utilise le point de terminaison Azure Active Directory. Vous devez donc l’enregistrer sur le [Portail Azure](https://ms.portal.azure.com/#blade/Microsoft_AAD_IAM/ApplicationsListBlade).
77+
78+
1. Connectez-vous au portail Microsoft Azure à l’aide d’un compte professionnel ou scolaire, ou d’un compte Microsoft personnel.
79+
1. Si votre compte vous propose un accès à plusieurs clients, sélectionnez votre compte en haut à droite et définissez votre session de portail sur le client Azure AD souhaité (à l’aide de Changer de répertoire).
80+
1. Dans le volet de navigation gauche, sélectionnez le service **Azure Active Directory**, puis sélectionnez **Inscriptions d’applications**
81+
![](readme-images/registrations.png).
82+
83+
1. Choisissez **Nouvelle inscription d’application**.
84+
85+
1. Entrez un nom convivial pour l’application.
86+
1. Choisissez « Web app/API » en tant que **Type d'application**.
87+
1. Entrez `http://localhost:3000/callback` comme **URL de connexion**.
88+
1. Dans la section types de comptes pris en charge, sélectionnez Comptes dans un annuaire organisationnel et les comptes personnels Microsoft (par ex. Skype, Xbox, Outlook.com).
89+
1. Cliquez sur **Créer**.
90+
91+
1. Choisissez votre nouvelle application dans la liste des applications enregistrées.
92+
Sur la page **Vue d’ensemble** de l’application, notez la valeur d'**ID d’application (client)** et conservez-la pour plus tard. Vous devez paramétrer le fichier de configuration de Visual Studio pour ce projet.
93+
![](readme-images/client.png)
94+
1. Configurez les autorisations pour votre application :
95+
96+
1. Choisissez **Paramètres** > **Autorisations nécessaires** > **Ajouter**.
97+
1. Choisissez **Sélectionner une API** > **Microsoft Graph**, puis cliquez sur **Sélectionner**.
98+
1. Choisissez **Sélectionner des autorisations**, faites défiler vers le bas jusqu’à **Autorisations déléguées**, sélectionnez **Mail.Read**, puis cliquez sur **Sélectionner**.
99+
1. Cliquez sur **Terminé**.
100+
![](readme-images/permissions.png)
101+
102+
1. Sélectionnez **Certificats & secrets** sous **Gérer**. Sélectionnez le bouton **Nouvelle clé secrète client**. Entrez une valeur dans la Description, puis sélectionnez l'une des options pour Expire le, et choisissez **Ajouter**.
103+
104+
![](readme-images/secrets.png)
105+
106+
1. **Important** : Copier la valeur de clé : elle constitue le secret de votre application. Vous ne pourrez pas accéder de nouveau à cette valeur après avoir quitté ce panneau.
107+
108+
Vous utiliserez l’**ID de l’application** et le **secret** pour configurer l’application.
109+
110+
## Configurer un tunnel pour votre localhost
111+
112+
L’exemple utilise localhost en tant que serveur de développement. Un tunnel est par conséquent nécessaire pour transférer les demandes d’une URL sur Internet vers votre localhost. Si, pour une raison quelconque, vous ne souhaitez pas utiliser de tunnel, consultez l'[Hébergement sans tunnel](https://github.com/OfficeDev/Microsoft-Graph-Nodejs-Webhooks/wiki/Hosting-the-sample-without-a-tunnel). Pour obtenir des explications détaillées sur l’utilisation d’un tunnel, consultez [Pourquoi dois-je utiliser un tunnel ?](https://github.com/OfficeDev/Microsoft-Graph-Nodejs-Webhooks/wiki/Why-do-I-have-to-use-a-tunnel)
113+
114+
Dans cet exemple, [ngrok](https://ngrok.com/) est utilisé pour créer le tunnel. Configuration de ngrok :
115+
116+
1. [Télécharger](https://ngrok.com/download) et décompresser des fichiers binaires ngrok pour votre plateforme.
117+
1. Tapez la commande suivante :
118+
119+
```Shell
120+
ngrok http 3000
121+
```
122+
123+
1. Notez l’*URL publique https* fourni par ngrok. Voici un exemple :
124+
125+
```http
126+
https://{NGROK_ID}.ngrok.io
127+
```
128+
129+
La valeur `NGROK_ID` est nécessaire dans la section suivante.
130+
131+
## Configurer et exécuter l’application web
132+
133+
1. Utilisez un éditeur de texte pour ouvrir `constants.js`.
134+
1. Remplacez `ENTER_YOUR_CLIENT_ID` par l’ID client de votre application Azure enregistrée.
135+
1. Remplacez `ENTER_YOUR_SECRET` par la clé secrète client de votre application Azure enregistrée.
136+
1. Remplacez `NGROK_ID` par la valeur dans l'*URL public https* de la section précédente.
137+
![](const)
138+
1. Installez les dépendances exécutant la commande suivante :
139+
140+
```Shell
141+
npm install
142+
```
143+
144+
1. Démarrez l’application avec la commande suivante :
145+
146+
```Shell
147+
npm start
148+
```
149+
> **Remarque :** Vous pouvez également faire en sorte que l'application attende un débogueur. Pour l'attente d'un débogueur, utilisez la commande suivante à la place :
150+
>
151+
> ```Shell
152+
> npm run debug
153+
> ```
154+
> Vous pouvez également joindre le débogueur inclus dans Microsoft Visual Studio Code. Pour plus d’informations, consultez le [Débogage dans Visual Studio Code](https://code.visualstudio.com/Docs/editor/debugging).
155+
156+
1. Ouvrez votre navigateur et accédez à [http://localhost:3000](http://localhost:3000).
157+
158+
## Contribution
159+
160+
Si vous souhaitez contribuer à cet exemple, voir [CONTRIBUTING.MD](/CONTRIBUTING.md).
161+
162+
Ce projet a adopté le [code de conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/). Pour en savoir plus, reportez-vous à la [FAQ relative au code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou contactez [[email protected]](mailto:[email protected]) pour toute question ou tout commentaire.
163+
164+
## Questions et commentaires
165+
166+
Nous serions ravis de connaître votre opinion sur l'application de l'exemple de webhook Microsoft Graph. Vous pouvez nous faire part de vos questions et suggestions dans la rubrique [Problèmes](https://github.com/OfficeDev/Microsoft-Graph-NodeJs-Webhooks/issues) de ce référentiel.
167+
168+
Vous avez des questions sur le développement dans Office 365 ? Publiez-les sur [Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API). N'oubliez pas de poser vos questions ou commentaires en incluant les balises \[API] et \[Office365].
169+
170+
## Ressources supplémentaires
171+
172+
- [Présentation de Microsoft Graph](http://graph.microsoft.io/)
173+
- [Documentation de référence sur l'inscription](https://graph.microsoft.io/en-us/docs/api-reference/beta/resources/subscription)
174+
175+
## Copyright
176+
177+
Copyright (c) 2019 Microsoft. Tous droits réservés.

0 commit comments

Comments
 (0)