Skip to content
This repository was archived by the owner on May 9, 2020. It is now read-only.

Commit e207ce2

Browse files
jasonjohjasonjoh
authored
Merge pull request #16 from OfficeGlobal/master
HB of localized readme files
2 parents a41328b + 68a5e87 commit e207ce2

File tree

6 files changed

+739
-0
lines changed

6 files changed

+739
-0
lines changed

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

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
---
2+
page_type: sample
3+
products:
4+
- office-outlook
5+
- ms-graph
6+
languages:
7+
- csharp
8+
description: "En este ejemplo se muestra cómo conectar una aplicación de consola de Windows a una cuenta de Microsoft profesional o educativa (Azure Active Directory) o a una cuenta personal (Microsoft) usando la API de Microsoft Graph para enviar un correo electrónico"
9+
extensions:
10+
contentType: samples
11+
technologies:
12+
- Microsoft Graph
13+
- Microsoft identity platform
14+
services:
15+
- Microsoft identity platform
16+
- Outlook
17+
createdDate: 12/11/2017 1:55:47 PM
18+
---
19+
# Ejemplo de conexión de consola con Microsoft Graph y C#
20+
21+
## Tabla de contenido
22+
23+
* [Introducción](#introduction)
24+
* [Requisitos previos](#prerequisites)
25+
* [Clonar o descargar el repositorio](#cloning-or-downloading-repo)
26+
* [Configurar el inquilino de Azure AD](#configuring-Azure-AD-tenant )
27+
* [Configurar el ejemplo para usar el inquilino de Azure AD](#configuring-sample-to-use-Azure-AD-tenant)
28+
* [Compilar y ejecutar el ejemplo](#build-and-run-sample)
29+
* [Preguntas y comentarios](#questions-and-comments)
30+
* [Colaboradores](#contributing)
31+
* [Recursos adicionales](#additional-resources)
32+
33+
## Introducción
34+
35+
En este ejemplo se muestra cómo conectar una aplicación de consola de Windows a una cuenta de Microsoft profesional o educativa (Azure Active Directory) o a una cuenta personal (Microsoft) usando la API de Microsoft Graph. Se usa la API de Microsoft Graph para recuperar la imagen de perfil de un usuario, cargarla a OneDrive, crear un vínculo de uso compartido y enviar un correo electrónico que contenga la foto como archivo adjunto y el vínculo de uso compartido en el texto. Usa la biblioteca cliente de .NET de Microsoft Graph para trabajar con los datos devueltos por Microsoft Graph. En el ejemplo se usa el punto de conexión de Azure AD v2.0, que permite a los usuarios iniciar sesión con sus cuentas Microsoft personales, o bien con sus cuentas Microsoft profesionales o educativas.
36+
37+
El ejemplo usa la Biblioteca de autenticación de Microsoft (MSAL) para la autenticación.
38+
39+
## Requisitos previos
40+
41+
Este ejemplo necesita lo siguiente:
42+
43+
- [Visual Studio](https://www.visualstudio.com/en-us/downloads) con la versión 7 de C# o superior.
44+
- Una cuenta [Microsoft](www.outlook.com) o una [cuenta de Office 365 para empresas](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account).
45+
- Inquilino de Azure Active Directory (Azure AD) Para obtener más información sobre cómo conseguir un inquilino de Azure AD, consulte [cómo obtener un inquilino de Azure AD](https://azure.microsoft.com/en-us/documentation/articles/active-directory-howto-tenant/).
46+
47+
## Cómo ejecutar este ejemplo
48+
49+
<a name="cloning-or-downloading-repo"></a>
50+
### Paso 1: Clonar o descargar el repositorio.
51+
52+
Desde la línea de comandos o shell:
53+
54+
`git clone https://github.com/microsoftgraph/console-csharp-connect-sample`
55+
56+
<a name="configuring-Azure-AD-tenant"></a>
57+
### Paso 2: Configurar el inquilino de Azure AD
58+
59+
1. Inicie sesión en [Microsoft Azure Portal](https://portal.azure.com) con una cuenta personal, profesional o educativa de Microsoft.
60+
2. Si la cuenta proporciona acceso a más de un inquilino, haga clic en la cuenta en la esquina superior derecha y establezca la sesión del portal en el inquilino de Azure AD deseado (mediante **Cambiar directorio**).
61+
3. En el panel de navegación izquierdo, seleccione el servicio **Azure Active Directory** y, después, seleccione **Registros de aplicaciones
62+
(versión preliminar)**.
63+
64+
#### Registro de la aplicación cliente
65+
![](https://github.com/nicolesigei/console-csharp-connect-sample/blob/master/readme-images/registrations.png)
66+
1. En la página **Registros de aplicaciones**, seleccione **Registrar una aplicación**.
67+
1. En la página **Registros de aplicaciones (versión preliminar)**, seleccione **Registrar una aplicación**.
68+
2. Cuando aparezca la **página Registrar una aplicación**, escriba la información de registro de la aplicación:
69+
- En la sección **Nombre**, escriba un nombre de aplicación significativo, que será el que se muestre a los usuarios. Por ejemplo: `Aplicación de consola para Microsoft Graph`
70+
- En la sección **Tipos de cuenta admitidos**, seleccione **Cuentas en cualquier directorio de organización y cuentas de Microsoft personales (por ejemplo, Skype, Xbox, Outlook.com)**.
71+
- Seleccione **Registrar** para crear la aplicación.
72+
3. 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. Lo necesitará para configurar el archivo de configuración de Visual Studio para este proyecto.
73+
4. En la lista de páginas de la aplicación, seleccione **Autenticación**.
74+
75+
- Use *urn:ietf:wg:oauth:2.0:oob* en el cuadro de texto **URI de redirección** y seleccione el **Tipo** como cliente público (móvil y escritorio)
76+
![](https://github.com/nicolesigei/console-csharp-connect-sample/blob/master/readme-images/redirect.png)
77+
- En los *URI de redirección sugeridos para clientes públicos (móvil, escritorio)*, marque el segundo cuadro para que la aplicación pueda funcionar con las bibliotecas de MSAL utilizadas en la aplicación. (El cuadro debe contener la opción *urn:ietf:wg:oauth:2.0:oob*).
78+
5. En la lista de páginas de la aplicación, seleccione **Permisos de API**
79+
- Haga clic en el botón **Agregar un permiso** y
80+
- Asegúrese de está seleccionada la pestaña **API de Microsoft**.
81+
- En la sección *API de Microsoft más usadas*, haga clic en **Microsoft Graph**.
82+
- En la sección **Permisos delegados**, asegúrese de que están marcados los permisos correctos: **User.Read**, **Mail.Send** y **Files.ReadWrite**. Use el cuadro de búsqueda si es necesario.
83+
- Seleccione el botón **Agregar permisos**.
84+
85+
<a name="configuring-sample-to-use-Azure-AD-tenant"></a>
86+
### Paso 3: Configurar el ejemplo para usar el inquilino de Azure AD
87+
88+
En los pasos que se indican a continuación, *Id. de cliente* es lo mismo que *Id. de la aplicación* o *Id. de aplicación*.
89+
90+
Abra la solución en Visual Studio para configurar los proyectos.
91+
92+
#### Configurar la aplicación cliente
93+
94+
1. En la carpeta *console-csharp-connect-sample*, cambie el nombre del archivo `appsettings.json.example` a `appsettings.json`.
95+
1. Abra y edite el archivo `appsettings.json` para hacer el siguiente cambio:
96+
1. Busque la línea en la que `ClientId` se ha establecido como `YOUR_CLIENT_ID_HERE` y reemplace el valor existente con el Id. de aplicación (cliente) de la aplicación `Aplicación de consola para Microsoft Graph` que se había copiado desde Microsoft Azure Portal.
97+
98+
<a name="build-and-run-sample"></a>
99+
### Paso 4: Compilar y ejecutar el ejemplo
100+
101+
1. Abra la solución del ejemplo en Visual Studio.
102+
2. Pulse F5 para compilar y ejecutar el ejemplo. Esto restaurará las dependencias del paquete de NuGet y abrirá la aplicación de consola.
103+
3. Cuando se le solicite, autentíquese con su cuenta de Microsoft y conceda los permisos que necesita la aplicación.
104+
4. Siga las indicaciones para enviar un mensaje desde su cuenta a su propio correo o al de otra persona.
105+
106+
## Preguntas y comentarios
107+
108+
Nos encantaría recibir sus comentarios acerca de la aplicación de consola para la API de Microsoft Graph. Puede enviar sus preguntas y sugerencias en la sección de [Problemas](https://github.com/microsoftgraph/console-csharp-connect-sample/issues) de este repositorio.
109+
110+
Las preguntas sobre el desarrollo de Microsoft Graph en general deben enviarse a [Stack Overflow](https://stackoverflow.com/questions/tagged/microsoftgraph). Asegúrese de que sus preguntas o comentarios estén etiquetados con \[microsoftgraph].
111+
112+
## Colaboradores ##
113+
114+
Si quiere hacer su aportación a este ejemplo, vea [CONTRIBUTING.MD](/CONTRIBUTING.md).
115+
116+
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 [opencode@microsoft.com](mailto:opencode@microsoft.com) si tiene otras preguntas o comentarios.
117+
118+
## Recursos adicionales
119+
120+
- [Otros ejemplos de Microsoft Graph Connect](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect)
121+
- [Microsoft Graph](https://developer.microsoft.com/en-us/graph)
122+
123+
## Derechos de autor
124+
Copyright (c) 2019 Microsoft. Todos los derechos reservados.

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

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
---
2+
page_type: sample
3+
products:
4+
- office-outlook
5+
- ms-graph
6+
languages:
7+
- csharp
8+
description: "Cet exemple présente la connexion entre une application de console Windows et un compte professionnel, scolaire (Azure Active Directory) ou personnel (Microsoft) utilisant l’API Microsoft Graph pour envoyer un e-mail."
9+
extensions:
10+
contentType: samples
11+
technologies:
12+
- Microsoft Graph
13+
- Microsoft identity platform
14+
services:
15+
- Microsoft identity platform
16+
- Outlook
17+
createdDate: 12/11/2017 1:55:47 PM
18+
---
19+
# Exemple de connexion avec la console Microsoft Graph C#
20+
21+
## Table des matières
22+
23+
* [Introduction](#introduction)
24+
* [Conditions préalables](#prerequisites)
25+
* [Clonage ou téléchargement de ce référentiel](#cloning-or-downloading-repo)
26+
* [Configuration de votre client Azure AD](#configuring-Azure-AD-tenant )
27+
* [Configuration de l’échantillon pour utiliser votre client Azure AD](#configuring-sample-to-use-Azure-AD-tenant)
28+
* [Créer et exécuter l’exemple](#build-and-run-sample)
29+
* [Questions et commentaires](#questions-and-comments)
30+
* [Contribution](#contributing)
31+
* [Ressources supplémentaires](#additional-resources)
32+
33+
## Introduction
34+
35+
Cet exemple montre comment connecter une application de console Windows à un compte professionnel ou scolaire Microsoft (Azure Active Directory) ou un compte personnel (Microsoft) à l’aide de l’API Microsoft Graph. Il utilise l’API Microsoft Graph pour récupérer l’image de profil d’un utilisateur, charger l’image sur OneDrive, créer un lien de partage et envoyer un courrier e-mail contenant la photo sous forme de pièce jointe et le lien de partage dans son texte. Il utilise la bibliothèque cliente Microsoft Graph .NET pour exploiter les données renvoyées par Microsoft Graph. L’exemple utilise le point de terminaison Azure AD v 2.0, qui permet aux utilisateurs de se connecter avec leurs comptes Microsoft personnels, professionnels ou scolaires.
36+
37+
L’exemple utilise la Bibliothèque d’authentification Microsoft (MSAL) pour l’authentification.
38+
39+
## Conditions préalables
40+
41+
Cet exemple nécessite les éléments suivants :
42+
43+
- [Visual Studio](https://www.visualstudio.com/en-us/downloads) avec C# version 7 et les versions ultérieures.
44+
- Soit un compte [Microsoft](www.outlook.com), soit un [compte Office 365 pour entreprise](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account).
45+
- Un client Azure Active Directory (Azure AD). Pour plus d’informations sur la façon d’obtenir un client Azure AD, voir [Obtention d’un client Azure AD](https://azure.microsoft.com/en-us/documentation/articles/active-directory-howto-tenant/).
46+
47+
## Exécution de cet exemple
48+
49+
<a name="cloning-or-downloading-repo"></a>
50+
### Étape 1 : Clonage ou téléchargement de ce référentiel.
51+
52+
À partir de votre shell ou de la ligne de commande :
53+
54+
`git clone https://github.com/microsoftgraph/console-csharp-connect-sample`
55+
56+
<a name="configuring-Azure-AD-tenant"></a>
57+
### Étape 2 : [Configuration de votre client Azure AD](#configuring-Azure-AD-tenant )
58+
59+
60+
1. Connectez-vous au [portail Microsoft Azure](https://portal.azure.com) à l’aide d’un compte professionnel ou scolaire, ou d’un compte Microsoft personnel.
61+
2. Si votre compte vous propose un accès à plusieurs locataires, 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**).
62+
3. Dans le volet de navigation gauche, sélectionnez le service **Azure Active Directory**, puis sélectionnez **Inscriptions d’applications (préversion)**.
63+
64+
#### Inscription de l’application cliente
65+
![](https://github.com/nicolesigei/console-csharp-connect-sample/blob/master/readme-images/registrations.png)
66+
1. À la page **Inscriptions des applications**, sélectionnez **Inscrire une application**.
67+
1. À la page **Inscriptions des applications (préversion)**, sélectionnez **Inscrire une application**.
68+
2. Lorsque la **page Inscrire une application** s’affiche, entrez les informations relatives à l’inscription de votre application :
69+
- dans la **section Nom**, entrez un nom d’application significatif qui sera présenté aux utilisateurs de l’application, par exemple `Application console pour Microsoft Graph`
70+
- dans la section **Types de comptes pris en charge**, sélectionnez **Comptes dans un annuaire organisationnel et comptes personnels Microsoft (par exemple, Skype, Xbox, Outlook.com)**.
71+
- Sélectionnez **Inscrire** pour créer l’application.
72+
3. Sur la page **Vue d’ensemble** de l’application, notez la valeur **ID d’application (client)** et conservez-la pour plus tard. Vous en aurez besoin pour paramétrer le fichier de configuration de Visual Studio pour ce projet.
73+
4. Dans la liste des pages de l’application, sélectionnez **Authentification**.
74+
75+
- Utilisez *urn:ietf:wg:oauth:2.0:oob* dans la zone de texte **Redirect URI** et sélectionnez le **Type** en tant que client public (mobile et ordinateur de bureau)
76+
![](https://github.com/nicolesigei/console-csharp-connect-sample/blob/master/readme-images/redirect.png)
77+
- Dans la boîte de dialogue *URI de redirection suggérés pour les clients publics (mobile, bureau)*, cochez la deuxième zone pour que l’application puisse utiliser les bibliothèques MSAL utilisées dans l’application. (La zone doit contenir l’option *urn:ietf:wg:oauth:2.0:oob*).
78+
5. Dans la liste des pages de l’application, sélectionnez **Autorisations de l’API**
79+
- Cliquez sur le bouton **Ajouter une autorisation**, puis :
80+
- assurez-vous que l’onglet **API Microsoft** est sélectionné.
81+
- Dans la section *API Microsoft couramment utilisées*, cliquez sur **Microsoft Graph**. Dans la section **Autorisations déléguées**, assurez
82+
-vous que les autorisations appropriées sont cochées : **User.Read**, **Mail.Send** et **Files.ReadWrite**. Utilisez la zone de recherche, le cas échéant.
83+
- Sélectionnez le bouton **Ajouter des autorisations**.
84+
85+
<a name="configuring-sample-to-use-Azure-AD-tenant"></a>
86+
### Étape 3 : Configuration de l’échantillon pour utiliser votre client Azure AD
87+
88+
Dans les étapes ci-dessous, *ID client* est identique à *ID de l’application*.**
89+
90+
Ouvrez la solution dans Visual Studio pour configurer les projets.
91+
92+
#### Configurer le projet client
93+
94+
1. Dans le dossier *console-csharp-connect-sample*, renommez le fichier `appsettings.json.example` en `appsettings.json`.
95+
1. Ouvrez et modifiez le fichier `appSettings.json` pour apporter la modification suivante :
96+
1. Recherchez la ligne dans laquelle `ClientId` est défini comme `YOUR_CLIENT_ID_HERE` et remplacez la valeur existante par l’ID (client) de `l’application console pour Microsoft Graph` copié à partir du portail Azure.
97+
98+
<a name="build-and-run-sample"></a>
99+
### Étape 4 : Créer et exécuter l’exemple
100+
101+
1. Ouvrez l’exemple de solution dans Visual Studio.
102+
2. Appuyez sur F5 pour créer et exécuter l’exemple. Cela entraîne la restauration des dépendances du package NuGet et l’ouverture de l’application de la console.
103+
3. À l’invite, authentifiez-vous avec votre compte Microsoft et acceptez les autorisations requises par l’application.
104+
4. Suivez les invites pour envoyer un message de votre compte à vous-même ou à un autre utilisateur.
105+
106+
## Questions et commentaires
107+
108+
Nous serions ravis de connaître votre opinion sur l'application de console API Microsoft Graph. Vous pouvez nous faire part de vos questions et suggestions dans la rubrique [Problèmes](https://github.com/microsoftgraph/console-csharp-connect-sample/issues) de ce référentiel.
109+
110+
Les questions générales sur le développement de Microsoft Graph doivent être publiées sur [Stack Overflow](https://stackoverflow.com/questions/tagged/microsoftgraph). Veillez à poser vos questions ou à rédiger vos commentaires en utilisant la balise \[microsoftgraph].
111+
112+
## Contribution ##
113+
114+
Si vous souhaitez contribuer à cet exemple, voir [CONTRIBUTING.MD](/CONTRIBUTING.md).
115+
116+
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 [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou tout commentaire.
117+
118+
## Ressources supplémentaires
119+
120+
- [Autres exemples de connexion avec Microsoft Graph](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect)
121+
- [Microsoft Graph](https://developer.microsoft.com/en-us/graph)
122+
123+
## Copyright
124+
Copyright (c) 2019 Microsoft. Tous droits réservés.

0 commit comments

Comments
 (0)