[WIP] Implement Apps API

src/OneLoginClient/Converters/AppConverter.cs

@@ -0,0 +1,46 @@
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+using OneLogin.Types;
+using System;
+using System.Reflection;
+
+namespace OneLogin.Converters
+{
+	public class AppConverter<T> : JsonConverter where T : AppDetail, new()
+	{
+		public override bool CanConvert(Type objectType)
+		{
+			// ToDo: Build modern target framework without GetTypeInfo hack
+			return typeof(AppDetail).GetTypeInfo().IsAssignableFrom(objectType.GetTypeInfo());
+		}
+
+		public override bool CanWrite => false;
+
+		public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
+		{
+
+			JObject jObject = JObject.Load(reader);
+
+			AppConfiguration configTarget = null;
+			if (jObject.ContainsKey("auth_method"))
+			{
+				var authMethod = (int)jObject["auth_method"];
+				switch (authMethod)
+				{
+					case 2:
+						configTarget = new AppSamlConfiguration();
+						break;
+				}
+			}
+
+			var target = new T() { Configuration = configTarget };
+			serializer.Populate(jObject.CreateReader(), target);
+			return target;
+		}
+
+		public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
+		{
+			throw new NotImplementedException();
+		}
+	}
+}

src/OneLoginClient/Endpoints.cs

@@ -16,6 +16,11 @@ public static class Endpoints
         public const string BaseApi = OneLoginApiBase + API + ApiVersion;
         public const string BaseApi2 = OneLoginApiBase + API + ApiVersion2;
 
+        /// <summary>
+        /// https://api.{us_or_eu}.onelogin.com/api/2/apps
+        /// </summary>
+        public const string ONELOGIN_APPS = "apps";
+
         /// <summary>
         /// https://api.<us_or_eu>.onelogin.com/api/1/users
         /// </summary>

src/OneLoginClient/OneLoginClient.Apps.cs

@@ -0,0 +1,38 @@
+using OneLogin.Requests;
+using OneLogin.Responses;
+using OneLogin.Types;
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+namespace OneLogin
+{
+    public partial class OneLoginClient
+    {
+		public async Task<GetAppsResponse> GetApps(string name = null, int? connectorId = null, AppAuthMethod? authMethod = null)
+		{
+			var parameters = new Dictionary<string, string>
+				{
+					{"name", name},
+					{"connector_id", connectorId.HasValue ? connectorId.ToString() : string.Empty},
+					{"auth_method", authMethod.HasValue ? authMethod.ToString() : string.Empty}
+				};
+			return await GetResource<GetAppsResponse>($"/{Endpoints.API}{Endpoints.ApiVersion2}{Endpoints.ONELOGIN_APPS}", parameters);
+		}
+
+		public async Task<AppDetail> GetAppById(int appId)
+		{
+			return await GetResource<AppDetail>($"/{Endpoints.API}{Endpoints.ApiVersion2}{Endpoints.ONELOGIN_APPS}/{appId}");
+		}
+
+		public async Task<AppDetail> UpdateApp(UpdateAppRequest app)
+		{
+			return await PutResource<AppDetail>($"/{Endpoints.API}{Endpoints.ApiVersion2}{Endpoints.ONELOGIN_APPS}/{app.Id}", app);
+		}
+
+		public async Task<AppDetail> CreateApp(CreateAppRequest app)
+		{
+			return await PostResource<AppDetail>($"/{Endpoints.API}{Endpoints.ApiVersion2}{Endpoints.ONELOGIN_APPS}", app);
+		}
+	}
+}

src/OneLoginClient/OneLoginClient.Events.cs

@@ -1,6 +1,5 @@
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using System.Threading.Tasks;
 using OneLogin.Requests;
 using OneLogin.Responses;
@@ -46,14 +45,9 @@ public async Task<GetEventsResponse> GetEvents(string clientId = null, DateTime?
                     {"since", since.ToString()},
                     {"until", until.ToString()},
                     {"user_id", userId.ToString()},
-                }
-                .Where(kv => !string.IsNullOrWhiteSpace(kv.Value))
-                .Select(kv => $"{kv.Key}={kv.Value}")
-                .ToList();
+                };
 
-            var url = $"{Endpoints.ONELOGIN_EVENTS}{(parameters.Any() ? "?" : "")}" + string.Join("&", parameters);
-
-            return await GetResource<GetEventsResponse>(url);
+            return await GetResource<GetEventsResponse>(Endpoints.ONELOGIN_EVENTS, parameters);
         }
 
         /// <summary>

src/OneLoginClient/OneLoginClient.Users.cs

@@ -31,13 +31,9 @@ public async Task<GetUsersResponse> GetUsers(string directoryId = null, string e
                     {"until", until.ToString()},
                     {"username", userName},
                     {"userprincipalname", userPrincipalName}
-                }
-                .Where(kv => !string.IsNullOrWhiteSpace(kv.Value))
-                .Select(kv => $"{kv.Key}={kv.Value}")
-                .ToList();
+                };
 
-            var url = $"{Endpoints.ONELOGIN_USERS}{(parameters.Any() ? "?" : "")}" + string.Join("&", parameters);
-            return await GetResource<GetUsersResponse>(url);
+            return await GetResource<GetUsersResponse>(Endpoints.ONELOGIN_USERS, parameters);
         }
 
         /// <summary>

src/OneLoginClient/OneLoginClient.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using System.Net;
 using System.Net.Http;
 using System.Net.Http.Headers;
@@ -132,7 +133,30 @@ public async Task<List<T>> GetPreviousPages<T>(T source, int? pages = null) wher
             return results;
         }
 
+        /// <summary>
+        /// Utility method to call OneLogin GET API endpoints and deserialize response
+        /// </summary>
+        /// <typeparam name="T">The type of the object to deserialize.</typeparam>
+        /// <param name="path">The path of the API endpoint</param>
+        /// <param name="queryParameters">A dictionary of query string parameters</param>
+        /// <returns></returns>
+        public async Task<T> GetResource<T>(string path, Dictionary<string, string> queryParameters)
+        {
+            var parameters = queryParameters
+                .Where(kv => !string.IsNullOrWhiteSpace(kv.Value))
+                .Select(kv => $"{kv.Key}={kv.Value}")
+                .ToList();
 
+            var url = $"{path}{(parameters.Any() ? "?" : "")}" + string.Join("&", parameters);
+            return await GetResource<T>(url);
+        }
+
+        /// <summary>
+        /// Utility method to call OneLogin GET API endpoints and deserialize response
+        /// </summary>
+        /// <typeparam name="T">The type of the object to deserialize.</typeparam>
+        /// <param name="url">The relative URL (path and optional query string) of the API endpoint</param>
+        /// <returns></returns>
         public async Task<T> GetResource<T>(string url)
         {
             if (string.IsNullOrWhiteSpace(url)) { throw new ArgumentException(nameof(url)); }
@@ -142,6 +166,13 @@ public async Task<T> GetResource<T>(string url)
             return response;
         }
 
+        /// <summary>
+        /// Utility method to call OneLogin POST API endpoints and deserialize response
+        /// </summary>
+        /// <typeparam name="T">The type of the object to deserialize.</typeparam>
+        /// <param name="url">The relative URL (path and optional query string) of the API endpoint</param>
+        /// <param name="obj">The object to serialize</param>
+        /// <returns></returns>
         public async Task<T> PostResource<T>(string url, object obj)
         {
             if (obj == null) throw new ArgumentNullException(nameof(obj));
@@ -152,6 +183,13 @@ public async Task<T> PostResource<T>(string url, object obj)
             return response;
         }
 
+        /// <summary>
+        /// Utility method to call OneLogin PUT API endpoints and deserialize response
+        /// </summary>
+        /// <typeparam name="T">The type of the object to deserialize.</typeparam>
+        /// <param name="url">The relative URL (path and optional query string) of the API endpoint</param>
+        /// <param name="obj">The object to serialize</param>
+        /// <returns></returns>
         public async Task<T> PutResource<T>(string url, object obj)
         {
             if (obj == null) throw new ArgumentNullException(nameof(obj));
@@ -162,6 +200,12 @@ public async Task<T> PutResource<T>(string url, object obj)
             return response;
         }
 
+        /// <summary>
+        /// Utility method to call OneLogin DELETE API endpoints and deserialize response
+        /// </summary>
+        /// <typeparam name="T">The type of the object to deserialize.</typeparam>
+        /// <param name="url">The relative URL (path and optional query string) of the API endpoint</param>
+        /// <returns></returns>
         public async Task<T> DeleteResource<T>(string url)
         {
             if (string.IsNullOrWhiteSpace(url)) { throw new ArgumentException(nameof(url)); }

src/OneLoginClient/Requests/CreateAppRequest.cs

@@ -0,0 +1,19 @@
+using OneLogin.Types;
+using System;
+
+namespace OneLogin.Requests
+{
+	public class CreateAppRequest : AppDetail
+	{
+		public CreateAppRequest(int connectorId, string name)
+		{
+			if (string.IsNullOrEmpty(name))
+			{
+				throw new ArgumentNullException(nameof(name), "Name is required");
+			}
+
+			ConnectorId = connectorId;
+			Name = name;
+		}
+	}
+}

src/OneLoginClient/Requests/UpdateAppRequest.cs

@@ -0,0 +1,18 @@
+using OneLogin.Types;
+using System;
+
+namespace OneLogin.Requests
+{
+	public class UpdateAppRequest : AppDetail
+	{
+		public UpdateAppRequest(int appId)
+		{
+			if (appId <= 0)
+			{
+				throw new ArgumentOutOfRangeException(nameof(appId), "App Id is required in app parameter");
+			}
+
+			Id = appId;
+		}
+	}
+}

src/OneLoginClient/Responses/GetAppsResponse.cs

@@ -0,0 +1,11 @@
+using OneLogin.Types;
+using System;
+using System.Collections.Generic;
+
+namespace OneLogin.Responses
+{
+    public class GetAppsResponse : List<AppSummary>
+    {
+
+    }
+}

src/OneLoginClient/Serializer.cs

@@ -8,7 +8,7 @@ namespace OneLogin
     /// </summary>
     public class Serializer
     {
-        private static readonly JsonSerializer _serializer = new JsonSerializer { NullValueHandling = NullValueHandling.Ignore };
+        private static readonly JsonSerializer _serializer = new JsonSerializer { NullValueHandling = NullValueHandling.Ignore, ContractResolver = new SnakeCaseContractResolver() };
 
         /// <summary>
         /// Serializes the specified object to a JSON string.