Common interfaces, helpers and data models classes for Java Authentication Library

Collection of data models and helpers for authenticating against VSTS and TFS

License	MIT License
GroupId	com.microsoft.alm
ArtifactId	auth-common
Last Version	0.6.4
Release Date	Aug 14, 2018
Type	jar
Description	Common interfaces, helpers and data models classes for Java Authentication Library Collection of data models and helpers for authenticating against VSTS and TFS

Download auth-common

Filename	Size
auth-common-0.6.4.pom
auth-common-0.6.4.jar	62 KB
auth-common-0.6.4-sources.jar	37 KB
auth-common-0.6.4-javadoc.jar	213 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.microsoft.alm/auth-common/ -->
<dependency>
    <groupId>com.microsoft.alm</groupId>
    <artifactId>auth-common</artifactId>
    <version>0.6.4</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.microsoft.alm/auth-common/
implementation 'com.microsoft.alm:auth-common:0.6.4'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.microsoft.alm/auth-common/
implementation ("com.microsoft.alm:auth-common:0.6.4")

Apache Buildr

'com.microsoft.alm:auth-common:jar:0.6.4'

Apache Ivy

<dependency org="com.microsoft.alm" name="auth-common" rev="0.6.4">
  <artifact name="auth-common" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.microsoft.alm', module='auth-common', version='0.6.4')
)

Scala SBT

libraryDependencies += "com.microsoft.alm" % "auth-common" % "0.6.4"

Leiningen

[com.microsoft.alm/auth-common "0.6.4"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.slf4j : slf4j-api	jar	1.7.19

test (4)

Group / Artifact	Type	Version
org.slf4j : slf4j-nop	jar	1.7.19
junit : junit	jar	4.11
org.mockito : mockito-core	jar	1.7
org.codehaus.groovy : groovy	jar	2.4.5

Project Modules

There are no modules declared in this project.

Visual Studio Team Services Authentication Library for Java (Preview)

Retrieve OAuth2 Access Token or Personal Accesss Tokens for Visual Studio Team Services (visualstudio.com) accounts. Also provides secure storage for those secrets on different platforms.

To learn more about Visual Studio Team Services and our Java specific tools, please visit https://java.visualstudio.com.

What this library provides

This library provides:

1. a set of authenticators in the core module that can be used to retrieve credentials in the form of OAuth2 Access Token or Personal Access Token against any Visual Studio Team Services account.
2. a set of secure storage providers that store retrieved secrets, as well as In memory and File system backed insecure storages.
3. a set of providers that hide the interaction between storage and authenticator, and returns authenticated client that can be used directly against Visual Studio Team Services REST APIs.

Available Secure Storage Providers:

Secret Type	Windows (Credential Manager)	Linux (GNOME Keyring v2.22+)	Mac OSX (Keychain)
Username / Password Combo (Credential)	Yes	Yes	Yes
OAuth2 Access/Refresh Token (TokenPair)	Yes (On Windows 7, 8/8.1 and 10)	Yes	Yes
VSTS Personal Access Token (Token)	Yes	Yes	Yes

How to use this library

Maven is the preferred way to referencing this library.

  <dependency>
    <groupId>com.microsoft.alm</groupId>
    <artifactId>auth-providers</artifactId>
    <version>0.6.4</version>
  </dependency>

If only interested in specific modules:

  <dependency>
    <groupId>com.microsoft.alm</groupId>
    <artifactId>auth-secure-storage</artifactId>
    <version>0.6.4</version>
  </dependency>

  <dependency>
    <groupId>com.microsoft.alm</groupId>
    <artifactId>auth-core</artifactId>
    <version>0.6.4</version>
  </dependency>

Here is a Sample App that uses this library.

How to build

1. Oracle JDK 6
2. Maven 3.2+
3. mvn clean verify

How can I contribute?

This is a preview release, please open issues and give us feedback! We also welcome Pull Requests.

License

The MIT license can be found in LICENSE.txt

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Microsoft

Open source projects and samples from Microsoft

Versions

Version
0.6.4 Aug 14, 2018
0.6.3 Apr 7, 2017
0.6.2 Mar 23, 2017
0.6.1 Mar 20, 2017
0.6.0 Feb 28, 2017
0.5.0 Sep 28, 2016
0.4.0 Aug 16, 2016
0.3.0 Jul 19, 2016
0.2.2 Jul 1, 2016
0.2.1 Jun 30, 2016
0.2.0 Jun 30, 2016