org.gitlab4j.api.utils

Class AccessTokenUtils

java.lang.Object

org.gitlab4j.api.utils.AccessTokenUtils

public final class AccessTokenUtils
extends Object

This class uses HTML scraping to create and revoke GitLab personal access tokens, the user's Feed token, and for fetching the current Health Check access token.

NOTE: This relies on HTML scraping and has been tested on GitLab-CE 11.0.0 to 11.10.1 for proper functionality. It may not work on earlier or later versions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AccessTokenUtils.Scope This enum defines the available scopes for a personal access token.

Field Summary

Fields

Modifier and Type	Field and Description
protected static Pattern	AUTHENTICITY_TOKEN_PATTERN
protected static String	AUTHENTICITY_TOKEN_REGEX
protected static String	COOKIES_HEADER
protected static Pattern	FEED_TOKEN_PATTERN
protected static String	FEED_TOKEN_REGEX
protected static Pattern	HEALTH_CHECK_ACCESS_TOKEN_PATTERN
protected static String	HEALTH_CHECK_ACCESS_TOKEN_REGEX
protected static Pattern	NEW_USER_AUTHENTICITY_TOKEN_PATTERN
protected static String	NEW_USER_AUTHENTICITY_TOKEN_REGEX
protected static Pattern	PERSONAL_ACCESS_TOKEN_PATTERN
protected static String	PERSONAL_ACCESS_TOKEN_REGEX
protected static Pattern	REVOKE_PERSONAL_ACCESS_TOKEN_PATTERN
protected static String	REVOKE_PERSONAL_ACCESS_TOKEN_REGEX
protected static String	USER_AGENT

Constructor Summary

Constructors

Constructor and Description
AccessTokenUtils()

Method Summary

Modifier and Type	Method and Description
static StringBuilder	addFormData(StringBuilder formData, String name, String value) Adds the specified form param to the form data StringBuilder.
static String	createPersonalAccessToken(String baseUrl, String username, String password, String tokenName, AccessTokenUtils.Scope[] scopes) Create a GitLab personal access token with the provided configuration.
static String	createPersonalAccessToken(String baseUrl, String username, String password, String tokenName, List<AccessTokenUtils.Scope> scopes) Create a GitLab personal access token with the provided configuration.
protected static String	getContent(URLConnection connection) Reads and returns the content from the provided URLConnection.
static String	getFeedToken(String baseUrl, String username, String password) Fetches the user's GitLab Feed token using HTML scraping.
static String	getHealthCheckAccessToken(String baseUrl, String username, String password) Fetches the GitLab health check access token using HTML scraping.
protected static String	login(String baseUrl, String username, String password) Gets a GitLab session cookie by logging in the specified user.
protected static void	logout(String baseUrl, String cookies) Logs out the user associated with the GitLab session cookie.
static void	revokePersonalAccessToken(String baseUrl, String username, String password, String tokenName, AccessTokenUtils.Scope[] scopes) Revoke the first matching GitLab personal access token.
static void	revokePersonalAccessToken(String baseUrl, String username, String password, String tokenName, List<AccessTokenUtils.Scope> scopes) Revoke the first matching GitLab personal access token.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

USER_AGENT

protected static final String USER_AGENT

See Also:

Constant Field Values

COOKIES_HEADER

protected static final String COOKIES_HEADER

See Also:

Constant Field Values

NEW_USER_AUTHENTICITY_TOKEN_REGEX

protected static final String NEW_USER_AUTHENTICITY_TOKEN_REGEX

See Also:

Constant Field Values

NEW_USER_AUTHENTICITY_TOKEN_PATTERN

protected static final Pattern NEW_USER_AUTHENTICITY_TOKEN_PATTERN

AUTHENTICITY_TOKEN_REGEX

protected static final String AUTHENTICITY_TOKEN_REGEX

See Also:

Constant Field Values

AUTHENTICITY_TOKEN_PATTERN

protected static final Pattern AUTHENTICITY_TOKEN_PATTERN

PERSONAL_ACCESS_TOKEN_REGEX

protected static final String PERSONAL_ACCESS_TOKEN_REGEX

See Also:

Constant Field Values

PERSONAL_ACCESS_TOKEN_PATTERN

protected static final Pattern PERSONAL_ACCESS_TOKEN_PATTERN

REVOKE_PERSONAL_ACCESS_TOKEN_REGEX

protected static final String REVOKE_PERSONAL_ACCESS_TOKEN_REGEX

See Also:

Constant Field Values

REVOKE_PERSONAL_ACCESS_TOKEN_PATTERN

protected static final Pattern REVOKE_PERSONAL_ACCESS_TOKEN_PATTERN

FEED_TOKEN_REGEX

protected static final String FEED_TOKEN_REGEX

See Also:

Constant Field Values

FEED_TOKEN_PATTERN

protected static final Pattern FEED_TOKEN_PATTERN

HEALTH_CHECK_ACCESS_TOKEN_REGEX

protected static final String HEALTH_CHECK_ACCESS_TOKEN_REGEX

See Also:

Constant Field Values

HEALTH_CHECK_ACCESS_TOKEN_PATTERN

protected static final Pattern HEALTH_CHECK_ACCESS_TOKEN_PATTERN

Constructor Detail

AccessTokenUtils

public AccessTokenUtils()

Method Detail

createPersonalAccessToken

public static final String createPersonalAccessToken(String baseUrl,
                                                     String username,
                                                     String password,
                                                     String tokenName,
                                                     AccessTokenUtils.Scope[] scopes)
                                              throws GitLabApiException

Create a GitLab personal access token with the provided configuration.

Parameters:

baseUrl - the GitLab server base URL

username - the user name to create the personal access token for

password - the password of the user to create the personal access token for

tokenName - the name for the new personal access token

scopes - an array of scopes for the new personal access token

Returns:

the created personal access token

Throws:

GitLabApiException - if any exception occurs

createPersonalAccessToken

public static final String createPersonalAccessToken(String baseUrl,
                                                     String username,
                                                     String password,
                                                     String tokenName,
                                                     List<AccessTokenUtils.Scope> scopes)
                                              throws GitLabApiException

Create a GitLab personal access token with the provided configuration.

Parameters:

baseUrl - the GitLab server base URL

username - the user name to create the personal access token for

password - the password of the user to create the personal access token for

tokenName - the name for the new personal access token

scopes - a List of scopes for the new personal access token

Returns:

the created personal access token

Throws:

GitLabApiException - if any exception occurs

revokePersonalAccessToken

public static final void revokePersonalAccessToken(String baseUrl,
                                                   String username,
                                                   String password,
                                                   String tokenName,
                                                   AccessTokenUtils.Scope[] scopes)
                                            throws GitLabApiException

Revoke the first matching GitLab personal access token.

Parameters:

baseUrl - the GitLab server base URL

username - the user name to revoke the personal access token for

password - the password of the user to revoke the personal access token for

tokenName - the name of the personal access token to revoke

scopes - an array of scopes of the personal access token to revoke

Throws:

GitLabApiException - if any exception occurs

revokePersonalAccessToken

public static final void revokePersonalAccessToken(String baseUrl,
                                                   String username,
                                                   String password,
                                                   String tokenName,
                                                   List<AccessTokenUtils.Scope> scopes)
                                            throws GitLabApiException

Revoke the first matching GitLab personal access token.

Parameters:

baseUrl - the GitLab server base URL

username - the user name to revoke the personal access token for

password - the password of the user to revoke the personal access token for

tokenName - the name of the personal access token to revoke

scopes - a List of scopes of the personal access token to revoke

Throws:

GitLabApiException - if any exception occurs

getFeedToken

public static final String getFeedToken(String baseUrl,
                                        String username,
                                        String password)
                                 throws GitLabApiException

Fetches the user's GitLab Feed token using HTML scraping.

Parameters:

baseUrl - the GitLab server base URL

username - the user name the user to log in with

password - the password of the provided username

Returns:

the fetched Feed token

Throws:

GitLabApiException - if any exception occurs

getHealthCheckAccessToken

public static final String getHealthCheckAccessToken(String baseUrl,
                                                     String username,
                                                     String password)
                                              throws GitLabApiException

Fetches the GitLab health check access token using HTML scraping.

Parameters:

baseUrl - the GitLab server base URL

username - the user name of an admin user to log in with

password - the password of the provided username

Returns:

the fetched health check access token

Throws:

GitLabApiException - if any exception occurs

login

protected static final String login(String baseUrl,
                                    String username,
                                    String password)
                             throws GitLabApiException

Gets a GitLab session cookie by logging in the specified user.

Parameters:

baseUrl - the GitLab server base URL

username - the user name to to login for

password - the password of the user to login for

Returns:

the GitLab seesion token as a cookie value

Throws:

GitLabApiException - if any error occurs

logout

protected static final void logout(String baseUrl,
                                   String cookies)
                            throws GitLabApiException

Logs out the user associated with the GitLab session cookie.

Parameters:

baseUrl - the GitLab server base URL

cookies - the GitLab session cookie to logout

Throws:

GitLabApiException - if any error occurs

addFormData

public static final StringBuilder addFormData(StringBuilder formData,
                                              String name,
                                              String value)
                                       throws GitLabApiException

Adds the specified form param to the form data StringBuilder. If the provided formData is null, will create the StringBuilder instance first.

Parameters:

formData - the StringBuilder instance holding the form data, if null will create the StringBuilder

name - the form param name

value - the form param value

Returns:

the form data StringBuilder

Throws:

GitLabApiException - if any error occurs.

getContent

protected static String getContent(URLConnection connection)
                            throws GitLabApiException

Reads and returns the content from the provided URLConnection.

Parameters:

connection - the URLConnection to read the content from

Returns:

the read content as a String

Throws:

GitLabApiException - if any error occurs