net.leanix.mtm.api.IdmApi Maven / Gradle / Ivy
/*
* The MIT License (MIT)
*
* Copyright (c) 2015 LeanIX GmbH
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
package net.leanix.mtm.api;
import net.leanix.dropkit.api.Client;
import net.leanix.dropkit.api.ApiException;
import net.leanix.dropkit.api.ValidationException;
import net.leanix.dropkit.api.Response;
import javax.ws.rs.core.MultivaluedHashMap;
import javax.ws.rs.core.MediaType;
import com.sun.jersey.api.client.UniformInterfaceException;
import net.leanix.mtm.api.models.Review;
import net.leanix.mtm.api.models.PermissionListResponse;
import net.leanix.mtm.api.models.Activation;
import net.leanix.mtm.api.models.Login;
import net.leanix.mtm.api.models.CredentialsResponse;
import net.leanix.mtm.api.models.Invitation;
import net.leanix.mtm.api.models.Credentials;
import net.leanix.mtm.api.models.UserResponse;
import java.util.*;
public class IdmApi
{
private Client apiClient;
public IdmApi(Client client)
{
if (client == null)
throw new IllegalArgumentException("client is null");
this.apiClient = client;
}
public Client getClient()
{
return this.apiClient;
}
/**
* authenticate.
* Endpoint to check user credentials (netId + password) for system users.
*
* @throws ApiException
*/
public UserResponse authenticate (Credentials body) throws ApiException
{
// create path and map variables
String path = "/idm/authenticate".replaceAll("\\{format\\}","json");
// query params
Map queryParams = new HashMap();
Map headerParams = new HashMap();
try
{
return apiClient.resource(path)
.queryParams(new MultivaluedHashMap(queryParams))
.type(MediaType.APPLICATION_JSON).method("POST", UserResponse.class, body);
}
catch (UniformInterfaceException ex)
{
if(ex.getResponse().getStatus() == 404)
{
return null;
}
else if(ex.getResponse().getStatus() == 422)
{
throw new ValidationException(ex.getResponse().getEntity(Response.class));
}
else
{
throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
}
}
}
/**
* activate.
* User self activation
*
* @throws ApiException
*/
public UserResponse activate (Activation body) throws ApiException
{
// create path and map variables
String path = "/idm/activate".replaceAll("\\{format\\}","json");
// query params
Map queryParams = new HashMap();
Map headerParams = new HashMap();
try
{
return apiClient.resource(path)
.queryParams(new MultivaluedHashMap(queryParams))
.type(MediaType.APPLICATION_JSON).method("POST", UserResponse.class, body);
}
catch (UniformInterfaceException ex)
{
if(ex.getResponse().getStatus() == 404)
{
return null;
}
else if(ex.getResponse().getStatus() == 422)
{
throw new ValidationException(ex.getResponse().getEntity(Response.class));
}
else
{
throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
}
}
}
/**
* setPassword.
* Endpoint to finish the reset the password process.
*
* @throws ApiException
*/
public UserResponse setPassword (Credentials body) throws ApiException
{
// create path and map variables
String path = "/idm/set-password".replaceAll("\\{format\\}","json");
// query params
Map queryParams = new HashMap();
Map headerParams = new HashMap();
try
{
return apiClient.resource(path)
.queryParams(new MultivaluedHashMap(queryParams))
.type(MediaType.APPLICATION_JSON).method("POST", UserResponse.class, body);
}
catch (UniformInterfaceException ex)
{
if(ex.getResponse().getStatus() == 404)
{
return null;
}
else if(ex.getResponse().getStatus() == 422)
{
throw new ValidationException(ex.getResponse().getEntity(Response.class));
}
else
{
throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
}
}
}
/**
* login.
* Notifies MTM of a login at a remote workspace. Can be called by systems only.
*
* @throws ApiException
*/
public UserResponse login (Login body) throws ApiException
{
// create path and map variables
String path = "/idm/login".replaceAll("\\{format\\}","json");
// query params
Map queryParams = new HashMap();
Map headerParams = new HashMap();
try
{
return apiClient.resource(path)
.queryParams(new MultivaluedHashMap(queryParams))
.type(MediaType.APPLICATION_JSON).method("POST", UserResponse.class, body);
}
catch (UniformInterfaceException ex)
{
if(ex.getResponse().getStatus() == 404)
{
return null;
}
else if(ex.getResponse().getStatus() == 422)
{
throw new ValidationException(ex.getResponse().getEntity(Response.class));
}
else
{
throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
}
}
}
/**
* resetPassword.
* Endpoint to start the reset the password process, can only be accessed by systems.
*
* @throws ApiException
*/
public CredentialsResponse resetPassword (Credentials body) throws ApiException
{
// create path and map variables
String path = "/idm/reset-password".replaceAll("\\{format\\}","json");
// query params
Map queryParams = new HashMap();
Map headerParams = new HashMap();
try
{
return apiClient.resource(path)
.queryParams(new MultivaluedHashMap(queryParams))
.type(MediaType.APPLICATION_JSON).method("POST", CredentialsResponse.class, body);
}
catch (UniformInterfaceException ex)
{
if(ex.getResponse().getStatus() == 404)
{
return null;
}
else if(ex.getResponse().getStatus() == 422)
{
throw new ValidationException(ex.getResponse().getEntity(Response.class));
}
else
{
throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
}
}
}
/**
* getUserByApiKey.
* Find a user by api key (for instances only).
*
* @throws ApiException
*/
public UserResponse getUserByApiKey (String apiKey) throws ApiException
{
// verify required params are set
if(apiKey == null )
{
throw new ApiException(400, "missing required params");
}
// create path and map variables
String path = "/idm/user/{apiKey}".replaceAll("\\{format\\}","json").replaceAll("\\{" + "apiKey" + "\\}", apiKey.toString());
// query params
Map queryParams = new HashMap();
Map headerParams = new HashMap();
try
{
return apiClient.resource(path)
.queryParams(new MultivaluedHashMap(queryParams))
.method("GET", UserResponse.class);
}
catch (UniformInterfaceException ex)
{
if(ex.getResponse().getStatus() == 404)
{
return null;
}
else if(ex.getResponse().getStatus() == 422)
{
throw new ValidationException(ex.getResponse().getEntity(Response.class));
}
else
{
throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
}
}
}
/**
* invite.
* Invite a user to a workspace
*
* @throws ApiException
*/
public UserResponse invite (Invitation body) throws ApiException
{
// create path and map variables
String path = "/idm/invite".replaceAll("\\{format\\}","json");
// query params
Map queryParams = new HashMap();
Map headerParams = new HashMap();
try
{
return apiClient.resource(path)
.queryParams(new MultivaluedHashMap(queryParams))
.type(MediaType.APPLICATION_JSON).method("POST", UserResponse.class, body);
}
catch (UniformInterfaceException ex)
{
if(ex.getResponse().getStatus() == 404)
{
return null;
}
else if(ex.getResponse().getStatus() == 422)
{
throw new ValidationException(ex.getResponse().getEntity(Response.class));
}
else
{
throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
}
}
}
/**
* review.
* Confirm or deny an invitation
*
* @throws ApiException
*/
public PermissionListResponse review (Review body) throws ApiException
{
// create path and map variables
String path = "/idm/review".replaceAll("\\{format\\}","json");
// query params
Map queryParams = new HashMap();
Map headerParams = new HashMap();
try
{
return apiClient.resource(path)
.queryParams(new MultivaluedHashMap(queryParams))
.type(MediaType.APPLICATION_JSON).method("POST", PermissionListResponse.class, body);
}
catch (UniformInterfaceException ex)
{
if(ex.getResponse().getStatus() == 404)
{
return null;
}
else if(ex.getResponse().getStatus() == 422)
{
throw new ValidationException(ex.getResponse().getEntity(Response.class));
}
else
{
throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
}
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy