/// <summary>
/// Queries the Cireson Portal for the specified user's security rights
/// </summary>
/// <param name="authToken">AuthorizationToken to use</param>
/// <param name="userName">User name to query</param>
/// <param name="domain">Domain of the user</param>
/// <returns></returns>
public static async Task <ConsoleUser> GetUserRights(AuthorizationToken authToken, string userName, string domain)
{
if (!authToken.IsValid)
{
throw new InvalidCredentialException("AuthorizationToken is not valid.");
}
string endpointUrl = IS_USER_AUTHORIZED_ENDPOINT + "?userName="******"&domain=" + domain;
try
{
// Initialize the HTTP helper and get going
PortalHttpHelper helper = new PortalHttpHelper(authToken);
string result = await helper.PostAsync(endpointUrl, String.Empty);
// Deserialize the object to an ExpandoObject and return a ConsoleUser
ExpandoObjectConverter converter = new ExpandoObjectConverter();
dynamic obj = JsonConvert.DeserializeObject <ExpandoObject>(result, converter);
ConsoleUser returnObj = new ConsoleUser(obj);
returnObj.IncidentSupportGroups = await GetUsersTierQueueEnumerations(authToken, returnObj);
return(returnObj);
}
catch (Exception)
{
throw; // Rethrow exceptions
}
}
/// <summary>
/// Retrieves an authorization token from the server
/// </summary>
/// <param name="portalUrl">URL of the Cireson Portal</param>
/// <param name="userName">User name</param>
/// <param name="password">User's password</param>
/// <param name="languageCode">Portal language code</param>
/// <exception cref="System.Security.Authentication.InvalidCredentialException">Thrown when user credentials are invalid.</exception>
/// <exception cref="CiresonPortalAPI.CiresonApiException">Thrown when an error occurs in the API.</exception>
/// <returns></returns>
public static async Task <AuthorizationToken> GetAuthorizationToken(string portalUrl, string userName, SecureString password, string domain, string languageCode = "ENU")
{
try
{
// First check to see if we have Windows Authentication enabled
bool windowsAuthEnabled = await DetectWindowsAuthentication(portalUrl);
// Set up credentials
PortalCredentials credentials = new PortalCredentials();
credentials.Username = userName;
credentials.SecurePassword = password;
credentials.Domain = domain;
// Initialize the HTTP helper and do the heavy lifting
PortalHttpHelper helper = new PortalHttpHelper(portalUrl, credentials, windowsAuthEnabled);
string result = await helper.PostAsync(AUTHORIZATION_ENDPOINT, JsonConvert.SerializeObject(new { UserName = credentials.Username, Password = credentials.Password, LanguageCode = languageCode }));
// Strip off beginning and ending quotes
result = result.TrimStart('\"').TrimEnd('\"');
// Create a new authorization token
AuthorizationToken token = new AuthorizationToken(portalUrl, credentials, languageCode, result, windowsAuthEnabled);
// Fetch this user's properties
ConsoleUser user = await AuthorizationController.GetUserRights(token, userName, domain);
token.User = user;
return(token);
}
catch
{
throw; // Rethrow exceptions
}
}
/// <summary>
/// Retrieves an authorization token from the server
/// </summary>
/// <param name="portalUrl">URL of the Cireson Portal</param>
/// <param name="userName">User name</param>
/// <param name="password">User's password</param>
/// <param name="languageCode">Portal language code</param>
/// <exception cref="System.Security.Authentication.InvalidCredentialException">Thrown when user credentials are invalid.</exception>
/// <exception cref="CiresonPortalAPI.CiresonApiException">Thrown when an error occurs in the API.</exception>
/// <returns></returns>
public static async Task<AuthorizationToken> GetAuthorizationToken(string portalUrl, string userName, SecureString password, string languageCode = "ENU")
{
try
{
// First check to see if we have Windows Authentication enabled
bool windowsAuthEnabled = await DetectWindowsAuthentication(portalUrl);
// Set up credentials
PortalCredentials credentials = new PortalCredentials();
credentials.Username = userName;
credentials.SecurePassword = password;
// Initialize the HTTP helper and do the heavy lifting
PortalHttpHelper helper = new PortalHttpHelper(portalUrl, credentials, windowsAuthEnabled);
string result = await helper.PostAsync(AUTHORIZATION_ENDPOINT, JsonConvert.SerializeObject(new { UserName = credentials.Username, Password = credentials.Password, LanguageCode = languageCode }));
// Strip off beginning and ending quotes
result = result.TrimStart('\"').TrimEnd('\"');
// Return the authorization token
return new AuthorizationToken(portalUrl, credentials, languageCode, result, windowsAuthEnabled);
}
catch
{
throw; // Rethrow exceptions
}
}
/// <summary>
/// Attempts to commit the type projection to the portal. Throws an exception if not successful.
/// </summary>
/// <param name="authToken">AuthorizationToken to use</param>
public async virtual Task <bool> Commit(AuthorizationToken authToken)
{
if (this.ReadOnly)
{
throw new CiresonApiException("Cannot commit a read-only type projection.");
}
if (!authToken.IsValid)
{
throw new InvalidCredentialException("AuthorizationToken is not valid.");
}
if (!this.IsDirty)
{
throw new CiresonApiException("Object is not dirty, Commit() aborted.");
}
// Every object needs a DisplayName set
if (string.IsNullOrEmpty(this.DisplayName))
{
this.DisplayName = this.DefaultDisplayName;
}
try
{
string jsonObj = this.Serialize();
// Initialize the HTTP helper and get going
PortalHttpHelper helper = new PortalHttpHelper(authToken);
string result = await helper.PostAsync(COMMIT_ENDPOINT, jsonObj);
// Retrieve the result
ExpandoObjectConverter converter = new ExpandoObjectConverter();
dynamic resultObj = JsonConvert.DeserializeObject <ExpandoObject>(result, converter);
// Throw an exception if we didn't succeed
if (!resultObj.success)
{
throw new CiresonApiException(resultObj.exception);
}
// Refresh object data from the server
await this.Refresh(authToken);
}
catch (Exception)
{
throw; // Rethrow exceptions
}
return(true);
}
/// <summary>
/// Creates an object projection using the specified data.
/// </summary>
/// <typeparam name="T">Type of projection to create</typeparam>
/// <param name="authToken">AuthorizationToken to use</param>
/// <param name="data">Data object to specify for creation</param>
/// <param name="readOnly">Should this projection be read only?</param>
/// <returns></returns>
private static async Task <T> CreateObjectFromData <T>(AuthorizationToken authToken, dynamic data, bool readOnly = false) where T : TypeProjection
{
if (!authToken.IsValid)
{
throw new InvalidCredentialException("AuthorizationToken is not valid.");
}
try
{
string jsonObj = JsonConvert.SerializeObject(data);
// Initialize the HTTP helper and get going
PortalHttpHelper helper = new PortalHttpHelper(authToken);
string result = await helper.PostAsync(CREATE_PROJECTION_BY_DATA_ENDPOINT, jsonObj);
// Retrieve the result
ExpandoObjectConverter converter = new ExpandoObjectConverter();
dynamic resultObj = JsonConvert.DeserializeObject <ExpandoObject>(result, converter);
// Throw an exception if we didn't succeed
if (!resultObj.success)
{
throw new CiresonApiException(resultObj.exception);
}
// Fetch the BaseId of the new object and create the projection
data.formJson.current.BaseId = new Guid(resultObj.BaseId);
// Instantiate
BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
CultureInfo culture = null;
T instanceType = (T)Activator.CreateInstance(typeof(T), flags, null, null, culture);
instanceType.CurrentObject = (data.formJson.current as ExpandoObject).DeepCopy();
instanceType.OriginalObject = data.formJson.current;
instanceType.ReadOnly = readOnly;
return(instanceType);
}
catch (Exception)
{
throw; // Rethrow exceptions
}
}
/// <summary>
/// Queries the Cireson Portal for objects using specified criteria.
/// </summary>
/// <param name="authToken">AuthenticationToken to use</param>
/// <param name="criteria">QueryCriteria rules</param>
/// <returns>List of TypeProjections</returns>
internal static async Task <List <T> > GetByCriteria <T>(AuthorizationToken authToken, QueryCriteria criteria) where T : TypeProjection
{
if (!authToken.IsValid)
{
throw new InvalidCredentialException("AuthorizationToken is not valid.");
}
try
{
// Initialize the HTTP helper and get going
PortalHttpHelper helper = new PortalHttpHelper(authToken);
string result = await helper.PostAsync(GET_BY_CRITERIA_ENDPOINT, criteria.ToString());
// TypeProjections have no set properties, so we deserialize to a list of ExpandoObjects
ExpandoObjectConverter converter = new ExpandoObjectConverter();
dynamic objectList = JsonConvert.DeserializeObject <List <ExpandoObject> >(result, converter);
// Convert the ExpandoObjects into proper TypeProjection objects
List <T> returnList = new List <T>();
foreach (ExpandoObject obj in objectList)
{
// Instantiate and add to the list
BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
CultureInfo culture = null;
T instanceType = (T)Activator.CreateInstance(typeof(T), flags, null, null, culture);
instanceType.CurrentObject = obj.DeepCopy();
instanceType.OriginalObject = obj;
instanceType.ReadOnly = false;
returnList.Add(instanceType);
}
return(returnList);
}
catch (Exception)
{
throw; // Rethrow exceptions
}
}
/// <summary>
/// Queries the Cireson Portal for the specified user's security rights
/// </summary>
/// <param name="authToken">AuthorizationToken to use</param>
/// <param name="userName">User name to query</param>
/// <param name="domain">Domain of the user</param>
/// <returns></returns>
public static async Task<ConsoleUser> GetUserRights(AuthorizationToken authToken, string userName, string domain)
{
if (!authToken.IsValid)
{
throw new InvalidCredentialException("AuthorizationToken is not valid.");
}
string endpointUrl = IS_USER_AUTHORIZED_ENDPOINT + "?userName="******"&domain=" + domain;
try
{
// Initialize the HTTP helper and get going
PortalHttpHelper helper = new PortalHttpHelper(authToken);
string result = await helper.PostAsync(endpointUrl, String.Empty);
// Deserialize the object to an ExpandoObject and return a ConsoleUser
ExpandoObjectConverter converter = new ExpandoObjectConverter();
dynamic obj = JsonConvert.DeserializeObject<ExpandoObject>(result, converter);
ConsoleUser returnObj = new ConsoleUser(obj);
returnObj.IncidentSupportGroups = await GetUsersTierQueueEnumerations(authToken, returnObj);
return returnObj;
}
catch (Exception e)
{
throw; // Rethrow exceptions
}
}