Expose introspect app API (#694)

Added new IntrospectApp method for AuthenticationClient. Now it's
possible to obtain application info like name, description, realm etc.
using access token.
Functional and integration tests added also.

Resolves: OLPEDGE-1489

Signed-off-by: Kostiantyn Zvieriev <[email protected]>

Author: kzvieriev

olp-cpp-sdk-authentication/include/olp/authentication/AuthenticationClient.h

@@ -26,6 +26,7 @@
 #include <string>
 
 #include <olp/authentication/AuthenticationSettings.h>
+#include <olp/authentication/Types.h>
 #include <olp/core/client/ApiResponse.h>
 #include <olp/core/client/CancellationToken.h>
 #include <olp/core/http/NetworkProxySettings.h>
@@ -585,6 +586,23 @@ class AUTHENTICATION_API AuthenticationClient {
       const std::string& user_access_token,
       const SignOutUserCallback& callback);
 
+  /**
+   * @brief Retrieves the application associated with the client access token.
+   *
+   * The application does not need permissions to access this endpoint.
+   * It will allow any client access token to retrieve its own information.
+   *
+   * @param access_token A valid access token that is associated with the
+   * application.
+   * @param callback The`IntrospectAppCallback` method that is called when
+   * the client introspect request is completed.
+   *
+   * @return The `CancellationToken` instance that can be used to cancel
+   * the request.
+   */
+  client::CancellationToken IntrospectApp(std::string access_token,
+                                          IntrospectAppCallback callback);
+
   /**
    * @brief Sets the `NetworkProxySettings` instance used by the underlying
    * network layer to make requests.

olp-cpp-sdk-authentication/include/olp/authentication/IntrospectAppResult.h

@@ -121,8 +121,6 @@ class AUTHENTICATION_API IntrospectAppResult {
   /**
    * @brief Token endpoint authentication method.
    *
-   * The default value will be "client_secret_jwt".
-   *
    * @return The token endpoint authentication method.
    */
   const std::string& GetTokenEndpointAuthMethod() const {

olp-cpp-sdk-authentication/include/olp/authentication/Types.h

@@ -0,0 +1,47 @@
+/*
+ * Copyright (C) 2020 HERE Europe B.V.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * License-Filename: LICENSE
+ */
+
+#pragma once
+
+#include <memory>
+
+#include <olp/authentication/AuthenticationError.h>
+#include <olp/authentication/IntrospectAppResult.h>
+#include <olp/core/client/ApiError.h>
+#include <olp/core/client/ApiResponse.h>
+
+namespace olp {
+namespace authentication {
+
+/// The response template type.
+template <typename ResultType>
+using Response = client::ApiResponse<ResultType, AuthenticationError>;
+
+/// The callback template type.
+template <typename ResultType>
+using Callback = std::function<void(Response<ResultType>)>;
+
+/// Defines the callback signature when the user request is completed.
+using IntrospectAppResponse = Response<IntrospectAppResult>;
+
+/// Called when the user introspect app request is completed.
+using IntrospectAppCallback = Callback<IntrospectAppResult>;
+
+}  // namespace authentication
+}  // namespace olp