libica.openapi.v3.TokenApi¶
All URIs are relative to /ica/rest
Method | HTTP request | Description |
---|---|---|
create_jwt_token | POST /api/tokens | Generate a JWT using an API-key, Basic Authentication or a psToken. |
refresh_jwt_token | POST /api/tokens:refresh | Refresh a JWT using a not yet expired, still valid JWT. |
create_jwt_token¶
Token create_jwt_token(tenant=tenant)
Generate a JWT using an API-key, Basic Authentication or a psToken.
Generate a JWT using an API-key, Basic Authentication or a psToken. When using Basic Authentication, and you are member of several tenants, also provide the tenant request parameter to indicate for which tenant you want to authenticate. Note that Basic Authentication will not work for SSO (Single Sign On) enabled authentication.
Example¶
- Bearer (psToken) Authentication (PsTokenAuth):
- Basic Authentication (BasicAuth):
- Api Key Authentication (ApiKeyAuth):
import libica.openapi.v3
from libica.openapi.v3.models.token import Token
from libica.openapi.v3.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to /ica/rest
# See configuration.py for a list of all supported configuration parameters.
configuration = libica.openapi.v3.Configuration(
host = "/ica/rest"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization (psToken): PsTokenAuth
configuration = libica.openapi.v3.Configuration(
access_token = os.environ["BEARER_TOKEN"]
)
# Configure HTTP basic authorization: BasicAuth
configuration = libica.openapi.v3.Configuration(
username = os.environ["USERNAME"],
password = os.environ["PASSWORD"]
)
# Configure API key authorization: ApiKeyAuth
configuration.api_key['ApiKeyAuth'] = os.environ["API_KEY"]
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKeyAuth'] = 'Bearer'
# Enter a context with an instance of the API client
with libica.openapi.v3.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = libica.openapi.v3.TokenApi(api_client)
tenant = 'tenant_example' # str | The name of your tenant in case you have access to multiple tenants. (optional)
try:
# Generate a JWT using an API-key, Basic Authentication or a psToken.
api_response = api_instance.create_jwt_token(tenant=tenant)
print("The response of TokenApi->create_jwt_token:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling TokenApi->create_jwt_token: %s\n" % e)
Parameters¶
Name | Type | Description | Notes |
---|---|---|---|
tenant | str | The name of your tenant in case you have access to multiple tenants. | [optional] |
Return type¶
Authorization¶
PsTokenAuth, BasicAuth, ApiKeyAuth
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/problem+json, application/vnd.illumina.v3+json
HTTP response details¶
Status code | Description | Response headers |
---|---|---|
200 | The JWT is successfully generated. | - |
0 | A problem occurred. | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
refresh_jwt_token¶
Token refresh_jwt_token()
Refresh a JWT using a not yet expired, still valid JWT.
When still having a valid JWT, this endpoint can be used to extend the validity.
Refreshing the JWT is not possible if it has been created using an API-key.
Example¶
- Bearer (JWT) Authentication (JwtAuth):
import libica.openapi.v3
from libica.openapi.v3.models.token import Token
from libica.openapi.v3.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to /ica/rest
# See configuration.py for a list of all supported configuration parameters.
configuration = libica.openapi.v3.Configuration(
host = "/ica/rest"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization (JWT): JwtAuth
configuration = libica.openapi.v3.Configuration(
access_token = os.environ["BEARER_TOKEN"]
)
# Enter a context with an instance of the API client
with libica.openapi.v3.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = libica.openapi.v3.TokenApi(api_client)
try:
# Refresh a JWT using a not yet expired, still valid JWT.
api_response = api_instance.refresh_jwt_token()
print("The response of TokenApi->refresh_jwt_token:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling TokenApi->refresh_jwt_token: %s\n" % e)
Parameters¶
This endpoint does not need any parameter.
Return type¶
Authorization¶
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/problem+json, application/vnd.illumina.v3+json
HTTP response details¶
Status code | Description | Response headers |
---|---|---|
200 | The JWT is successfully refreshed. | - |
0 | A problem occurred. | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]