https://github.com/microsoftgraph/msgraph-sdk-java-auth

Authentication Providers for Microsoft Graph Java SDK
https://github.com/microsoftgraph/msgraph-sdk-java-auth

devxeng

Last synced: 20 days ago
JSON representation

Authentication Providers for Microsoft Graph Java SDK

Host: GitHub
URL: https://github.com/microsoftgraph/msgraph-sdk-java-auth
Owner: microsoftgraph
Archived: true
Created: 2019-01-18T16:46:36.000Z (about 7 years ago)
Default Branch: dev
Last Pushed: 2021-02-11T20:57:30.000Z (almost 5 years ago)
Last Synced: 2024-04-24T06:32:01.031Z (almost 2 years ago)
Topics: devxeng
Language: Java
Size: 187 KB
Stars: 34
Watchers: 30
Forks: 22
Open Issues: 6
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md

Awesome Lists containing this project

README

          # Microsoft Graph Auth Preview SDK for Java

Get started with the Microsoft Graph SDK for Java by integrating the [Microsoft Graph API](https://developer.microsoft.com/en-us/graph/get-started/java) into your Java application!

## Important Note about the Microsoft Graph Auth Preview SDK for Java

During the preview we may make changes to the API, and other mechanisms of this library, which you will be required to take along with bug fixes or feature improvements. This may impact your application. An API change may require you to update your code. When we provide the General Availability release we will require you to update to the General Availability version within six months, as applications written using a preview version of library may no longer work.

## 1. Installation

### 1.1 Install via Gradle

Add the repository and a compile dependency for `microsoft-graph-auth` to your project's `build.gradle`:

```gradle

repository {

    maven { url 'https://oss.sonatype.org/content/repositories/snapshots' }

}

dependency {

    // Include the sdk as a dependency

    compile('com.microsoft.graph:microsoft-graph-auth:0.3.0-SNAPSHOT')

}

```

### 1.2 Install via Maven

Add the dependency in `dependencies` in pom.xml

```xml

	com.microsoft.graph

	microsoft-graph-auth

	0.3.0-SNAPSHOT

```

Add in `project`

```xml

  

     allow-snapshots

        true

     

       

         snapshots-repo

         https://oss.sonatype.org/content/repositories/snapshots

         false

         true

       

     

   

```

## 2. Getting started

### 2.1 Register your application

Register your application by following the steps at [Register your app with the Azure AD v2.0 endpoint](https://developer.microsoft.com/en-us/graph/docs/concepts/auth_register_app_v2).

### 2.2 Create an authentication provider object

#### 2.3.1 Confidential client authentication provider

##### a. Authorization code provider

```java

AuthorizationCodeProvider authProvider = new AuthorizationCodeProvider(CLIENT_ID, SCOPES, AUTHORIZATION_CODE, REDIRECT_URL, NATIONAL_CLOUD, TENANT, CLIENT_SECRET);

```

##### b. Client credential provider

```java

ClientCredentialProvider authProvider = new ClientCredentialProvider(CLIENT_ID, SCOPES, CLIENT_SECRET, TENANT_GUID, NATIONAL_CLOUD);

```

#### 2.3.2 Public client authentication provider

##### a. Username password provider

```java

UsernamePasswordProvider authProvider = new UsernamePasswordProvider(CLIENT_ID, SCOPES, USERNAME, PASSWORD, NATIONAL_CLOUD, TENANT, CLIENT_SECRET);

```

### 2.3 Get a HttpClient object and make a call

#### Using [msgraph-sdk-java](https://github.com/microsoftgraph/msgraph-sdk-java)

```java

IGraphServiceClient graphClient = GraphServiceClient

				.builder()

				.authenticationProvider(authProvider)

				.buildClient();

User user = graphClient.me().buildRequest().get();

```

#### Using [msgraph-sdk-java-core](https://github.com/microsoftgraph/msgraph-sdk-java-core)

```java

OkHttpClient client = HttpClients.createDefault(authProvider);

Request request = new Request.Builder().url("https://graph.microsoft.com/v1.0/me").build();

Response response = client.newCall(request).execute();

System.out.println(response.body().string());

```

## 3. Make requests against the service

After you have a GraphServiceClient that is authenticated, you can begin making calls against the service. The requests against the service look like our [REST API](https://developer.microsoft.com/en-us/graph/docs/concepts/overview).

### 3.1 Get the user's drive

#### To retrieve the user's drive:

##### Using [msgraph-sdk-java](https://github.com/microsoftgraph/msgraph-sdk-java)

```java

IGraphServiceClient graphClient = 

		GraphServiceClient

		.builder()

		.authenticationProvider(authProvider)

		.buildClient();

		

Drive drive = graphClient.me().drive().buildRequest().get();

```

##### Using [msgraph-sdk-java-core](https://github.com/microsoftgraph/msgraph-sdk-java-core)

```java

OkHttpClient httpclient = HttpClients.createDefault(authenticationProvider);

Request request = new Request.Builder().url("https://graph.microsoft.com/v1.0/me/drive").build();

Response response = client.newCall(request).execute();

System.out.println( respose.body().string() );

```

## 4. Sample

### 4.1 Authorization code provider

[Steps to get authorizationCode](https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-auth-code-flow#request-an-authorization-code)

```java

AuthorizationCodeProvider authProvider = new AuthorizationCodeProvider("6731de76-14a6-49ae-97bc-6eba6914391e", 

				Arrays.asList("https://graph.microsoft.com/user.read","https://graph.microsoft.com/Mail.ReadWrite"), 

				authorizationCode,

				"http://localhost/myapp/", 

				NationalCloud.Global, 

				"common", 

				"JqQX2PNo9bpM0uEihUPzyrh");

				

IGraphServiceClient graphClient = 

	GraphServiceClient

	.builder()

	.authenticationProvider(authProvider)

	.buildClient();

				

IMessageCollectionPage page = graphClient.me().messages().buildRequest().get();

while(page != null) {

	for(Message message : page.getCurrentPage()) {

		System.out.println(message.subject);

	}

	IMessageCollectionRequestBuilder builder = page.getNextPage();

	if(builder == null)break;

	page = builder.buildRequest().get();

}

```

## 5. Documentation

For more detailed documentation, see:

[Usage of these providers](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-protocols).

## 6. Issues

For known issues, see [issues](https://github.com/microsoftgraph/msgraph-sdk-java-auth/issues).

## 7. Contributions

The Microsoft Graph SDK is open for contribution. To contribute to this project, see [Contributing](https://github.com/microsoftgraph/msgraph-sdk-java/blob/master/CONTRIBUTING.md).

Thanks to everyone who has already devoted time to improving the library:

| [
_{Nakul Sabharwal}](https://developer.microsoft.com/graph)
[](#question-NakulSabharwal "Answering Questions") [](https://github.com/microsoftgraph/msgraph-sdk-java/commits?author=NakulSabharwal "Code") [](https://github.com/microsoftgraph/msgraph-sdk-java/wiki "Documentation") [](#review-NakulSabharwal "Reviewed Pull Requests") [](https://github.com/microsoftgraph/msgraph-sdk-java/commits?author=NakulSabharwal "Tests")| [
_{Deepak Agrawal}](https://github.com/deepak2016)
 

| :---: | :---: | 

This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind are welcome!

## 8. Supported Java versions

The Microsoft Graph SDK for Java library is supported at runtime for Java 7+ and [Android API revision 15](http://source.android.com/source/build-numbers.html) and greater.

## 9. License

Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the [MIT license](LICENSE).

## 10. Third-party notices

[Third-party notices](THIRD%20PARTY%20NOTICES)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/microsoftgraph/msgraph-sdk-java-auth

Awesome Lists containing this project

README