Skip to content
This repository has been archived by the owner on May 17, 2018. It is now read-only.

Latest commit

 

History

History
266 lines (182 loc) · 7.15 KB

AccessApi.md

File metadata and controls

266 lines (182 loc) · 7.15 KB

AccessApi

All URIs are relative to http://localhost/nifi-api

Method HTTP request Description
createAccessToken POST /access/token Creates a token for accessing the REST API via username/password
createAccessTokenFromTicket POST /access/kerberos Creates a token for accessing the REST API via Kerberos ticket exchange / SPNEGO negotiation
createDownloadToken POST /access/download-token Creates a single use access token for downloading FlowFile content.
createUiExtensionToken POST /access/ui-extension-token Creates a single use access token for accessing a NiFi UI extension.
getAccessStatus GET /access Gets the status the client's access
getLoginConfig GET /access/config Retrieves the access configuration for this NiFi

createAccessToken

String createAccessToken(username, password)

Creates a token for accessing the REST API via username/password

The token returned is formatted as a JSON Web Token (JWT). The token is base64 encoded and comprised of three parts. The header, the body, and the signature. The expiration of the token is a contained within the body. The token can be used in the Authorization header in the format 'Authorization: Bearer <token>'.

Example

// Import classes:
//import io.swagger.client.ApiException;
//import io.swagger.client.api.AccessApi;


AccessApi apiInstance = new AccessApi();
String username = "username_example"; // String | 
String password = "password_example"; // String | 
try {
    String result = apiInstance.createAccessToken(username, password);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccessApi#createAccessToken");
    e.printStackTrace();
}

Parameters

Name Type Description Notes
username String [optional]
password String [optional]

Return type

String

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/x-www-form-urlencoded
  • Accept: text/plain

createAccessTokenFromTicket

String createAccessTokenFromTicket()

Creates a token for accessing the REST API via Kerberos ticket exchange / SPNEGO negotiation

The token returned is formatted as a JSON Web Token (JWT). The token is base64 encoded and comprised of three parts. The header, the body, and the signature. The expiration of the token is a contained within the body. The token can be used in the Authorization header in the format 'Authorization: Bearer <token>'.

Example

// Import classes:
//import io.swagger.client.ApiException;
//import io.swagger.client.api.AccessApi;


AccessApi apiInstance = new AccessApi();
try {
    String result = apiInstance.createAccessTokenFromTicket();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccessApi#createAccessTokenFromTicket");
    e.printStackTrace();
}

Parameters

This endpoint does not need any parameter.

Return type

String

Authorization

No authorization required

HTTP request headers

  • Content-Type: text/plain
  • Accept: text/plain

createDownloadToken

String createDownloadToken()

Creates a single use access token for downloading FlowFile content.

The token returned is a base64 encoded string. It is valid for a single request up to five minutes from being issued. It is used as a query parameter name 'access_token'.

Example

// Import classes:
//import io.swagger.client.ApiException;
//import io.swagger.client.api.AccessApi;


AccessApi apiInstance = new AccessApi();
try {
    String result = apiInstance.createDownloadToken();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccessApi#createDownloadToken");
    e.printStackTrace();
}

Parameters

This endpoint does not need any parameter.

Return type

String

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/x-www-form-urlencoded
  • Accept: text/plain

createUiExtensionToken

String createUiExtensionToken()

Creates a single use access token for accessing a NiFi UI extension.

The token returned is a base64 encoded string. It is valid for a single request up to five minutes from being issued. It is used as a query parameter name 'access_token'.

Example

// Import classes:
//import io.swagger.client.ApiException;
//import io.swagger.client.api.AccessApi;


AccessApi apiInstance = new AccessApi();
try {
    String result = apiInstance.createUiExtensionToken();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccessApi#createUiExtensionToken");
    e.printStackTrace();
}

Parameters

This endpoint does not need any parameter.

Return type

String

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/x-www-form-urlencoded
  • Accept: text/plain

getAccessStatus

AccessStatusEntity getAccessStatus()

Gets the status the client's access

Note: This endpoint is subject to change as NiFi and it's REST API evolve.

Example

// Import classes:
//import io.swagger.client.ApiException;
//import io.swagger.client.api.AccessApi;


AccessApi apiInstance = new AccessApi();
try {
    AccessStatusEntity result = apiInstance.getAccessStatus();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccessApi#getAccessStatus");
    e.printStackTrace();
}

Parameters

This endpoint does not need any parameter.

Return type

AccessStatusEntity

Authorization

No authorization required

HTTP request headers

  • Content-Type: /
  • Accept: application/json

getLoginConfig

AccessConfigurationEntity getLoginConfig()

Retrieves the access configuration for this NiFi

Example

// Import classes:
//import io.swagger.client.ApiException;
//import io.swagger.client.api.AccessApi;


AccessApi apiInstance = new AccessApi();
try {
    AccessConfigurationEntity result = apiInstance.getLoginConfig();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccessApi#getLoginConfig");
    e.printStackTrace();
}

Parameters

This endpoint does not need any parameter.

Return type

AccessConfigurationEntity

Authorization

No authorization required

HTTP request headers

  • Content-Type: /
  • Accept: application/json