/*
 * Copyright (c) 2019, WSO2 LLC. (http://www.wso2.com) All Rights Reserved.
 *
 * WSO2 LLC. licenses this file to you 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.
 */

package org.wso2.carbon.identity.api.server.application.management.v1.core;

import org.apache.commons.collections.CollectionUtils;
import org.apache.commons.lang3.StringUtils;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants;
import org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants.ErrorMessage;
import org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementServiceHolder;
import org.wso2.carbon.identity.api.server.application.management.v1.AdaptiveAuthTemplates;
import org.wso2.carbon.identity.api.server.application.management.v1.AllowedIssuer;
import org.wso2.carbon.identity.api.server.application.management.v1.AuthProtocolMetadata;
import org.wso2.carbon.identity.api.server.application.management.v1.CIBAMetadata;
import org.wso2.carbon.identity.api.server.application.management.v1.CIBANotificationChannel;
import org.wso2.carbon.identity.api.server.application.management.v1.ClientAuthenticationMethod;
import org.wso2.carbon.identity.api.server.application.management.v1.ClientAuthenticationMethodMetadata;
import org.wso2.carbon.identity.api.server.application.management.v1.CustomInboundProtocolMetaData;
import org.wso2.carbon.identity.api.server.application.management.v1.CustomInboundProtocolProperty;
import org.wso2.carbon.identity.api.server.application.management.v1.FapiMetadata;
import org.wso2.carbon.identity.api.server.application.management.v1.GrantType;
import org.wso2.carbon.identity.api.server.application.management.v1.GrantTypeMetaData;
import org.wso2.carbon.identity.api.server.application.management.v1.MetadataProperty;
import org.wso2.carbon.identity.api.server.application.management.v1.OIDCMetaData;
import org.wso2.carbon.identity.api.server.application.management.v1.SAMLMetaData;
import org.wso2.carbon.identity.api.server.application.management.v1.WSTrustMetaData;
import org.wso2.carbon.identity.api.server.application.management.v1.core.functions.Utils;
import org.wso2.carbon.identity.api.server.common.ContextLoader;
import org.wso2.carbon.identity.api.server.common.error.APIError;
import org.wso2.carbon.identity.application.common.model.Property;
import org.wso2.carbon.identity.application.mgt.AbstractInboundAuthenticatorConfig;
import org.wso2.carbon.identity.application.mgt.ApplicationManagementService;
import org.wso2.carbon.identity.base.IdentityException;
import org.wso2.carbon.identity.core.util.IdentityUtil;
import org.wso2.carbon.identity.oauth.OAuthAdminServiceImpl;
import org.wso2.carbon.identity.oauth.ciba.api.CibaAuthServiceImpl;
import org.wso2.carbon.identity.oauth.common.OAuthConstants;
import org.wso2.carbon.identity.oauth.dto.OAuthIDTokenAlgorithmDTO;
import org.wso2.carbon.identity.oauth.dto.TokenBindingMetaDataDTO;
import org.wso2.carbon.identity.oauth2.config.exceptions.OAuth2OIDCConfigOrgUsageScopeMgtException;
import org.wso2.carbon.identity.oauth2.config.models.IssuerDetails;
import org.wso2.carbon.identity.oauth2.config.services.OAuth2OIDCConfigOrgUsageScopeMgtService;
import org.wso2.carbon.identity.oauth2.fapi.exceptions.FapiConfigMgtException;
import org.wso2.carbon.identity.oauth2.fapi.models.FapiConfig;
import org.wso2.carbon.identity.oauth2.fapi.models.FapiProfileEnum;
import org.wso2.carbon.identity.oauth2.fapi.services.FapiConfigMgtService;
import org.wso2.carbon.identity.oauth2.model.ClientAuthenticationMethodModel;
import org.wso2.carbon.identity.oauth2.util.OAuth2Util;
import org.wso2.carbon.identity.sso.saml.SAMLSSOConfigServiceImpl;
import org.wso2.carbon.security.SecurityConfigException;
import org.wso2.carbon.security.sts.service.STSAdminServiceInterface;

import java.net.URLDecoder;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashSet;
import java.util.LinkedList;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.stream.Collectors;

import static org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants.DEFAULT_CERTIFICATE_ALIAS;
import static org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants.DEFAULT_NAME_ID_FORMAT;
import static org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants.ErrorMessage.ERROR_RETRIEVING_ALLOWED_ISSUERS;
import static org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants.ErrorMessage.ERROR_RETRIEVING_SAML_METADATA;
import static org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants.ErrorMessage.ERROR_WS_TRUST_METADATA_SERVICE_NOT_FOUND;
import static org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants.getCibaNotificationChannelNames;
import static org.wso2.carbon.identity.api.server.application.management.common.ApplicationManagementConstants.getOAuthGrantTypeNames;

/**
 * Calls internal osgi services to get required application metadata.
 */
public class ServerApplicationMetadataService {

    private final ApplicationManagementService applicationManagementService;
    private final SAMLSSOConfigServiceImpl samlSSOConfigService;
    private final OAuthAdminServiceImpl oAuthAdminService;
    private final STSAdminServiceInterface sTSAdminServiceInterface;
    private final CibaAuthServiceImpl cibaAuthService;
    private final FapiConfigMgtService fapiConfigMgtService;

    @Deprecated
    public ServerApplicationMetadataService(ApplicationManagementService applicationManagementService,
                                            SAMLSSOConfigServiceImpl samlSSOConfigService,
                                            OAuthAdminServiceImpl oAuthAdminService,
                                            STSAdminServiceInterface sTSAdminServiceInterface) {

        this(applicationManagementService, samlSSOConfigService, oAuthAdminService, sTSAdminServiceInterface,
                ApplicationManagementServiceHolder.getCibaAuthService(),
                ApplicationManagementServiceHolder.getFapiConfigMgtService());
    }

    @Deprecated
    public ServerApplicationMetadataService(ApplicationManagementService applicationManagementService,
                                            SAMLSSOConfigServiceImpl samlSSOConfigService,
                                            OAuthAdminServiceImpl oAuthAdminService,
                                            STSAdminServiceInterface sTSAdminServiceInterface,
                                            CibaAuthServiceImpl cibaAuthService) {

        this(applicationManagementService, samlSSOConfigService, oAuthAdminService, sTSAdminServiceInterface,
                cibaAuthService, ApplicationManagementServiceHolder.getFapiConfigMgtService());
    }

    public ServerApplicationMetadataService(ApplicationManagementService applicationManagementService,
                                            SAMLSSOConfigServiceImpl samlSSOConfigService,
                                            OAuthAdminServiceImpl oAuthAdminService,
                                            STSAdminServiceInterface sTSAdminServiceInterface,
                                            CibaAuthServiceImpl cibaAuthService,
                                            FapiConfigMgtService fapiConfigMgtService) {

        this.applicationManagementService = applicationManagementService;
        this.samlSSOConfigService = samlSSOConfigService;
        this.oAuthAdminService = oAuthAdminService;
        this.sTSAdminServiceInterface = sTSAdminServiceInterface;
        this.cibaAuthService = cibaAuthService;
        this.fapiConfigMgtService = fapiConfigMgtService;
    }

    private static final Log LOG = LogFactory.getLog(ServerApplicationMetadataService.class);

    /**
     * Return a list of all available inbound protocols. If the customOnly parameter set to True, will return only the
     * custom protocols.
     *
     * @param customOnly Set to True to get only custom protocols. Default value: False.
     * @return The list of inbound protocols.
     */
    public List<AuthProtocolMetadata> getInboundProtocols(Boolean customOnly) {

        List<AuthProtocolMetadata> authProtocolMetadataList = new ArrayList<>();

        // Add custom inbound protocols
        Map<String, AbstractInboundAuthenticatorConfig> allCustomAuthenticators = applicationManagementService
                .getAllInboundAuthenticatorConfig();

        for (Map.Entry<String, AbstractInboundAuthenticatorConfig> entry : allCustomAuthenticators
                .entrySet()) {
            AuthProtocolMetadata protocol = new AuthProtocolMetadata()
                    .name(entry.getValue().getName())
                    .displayName(entry.getValue().getFriendlyName());
            authProtocolMetadataList.add(protocol);
        }

        if (customOnly == null || !customOnly) {
            // Add default inbound protocols. WS-Federation (Passive) is not added because it doesn't have metadata,
            authProtocolMetadataList.add(new AuthProtocolMetadata().name("saml")
                    .displayName("SAML2 Web SSO Configuration"));
            authProtocolMetadataList.add(new AuthProtocolMetadata().name("oidc")
                    .displayName("OAuth/OpenID Connect Configuration"));
            authProtocolMetadataList.add(new AuthProtocolMetadata().name("ws-trust")
                    .displayName("WS-Trust Security Token Service Configuration"));
        }

        return authProtocolMetadataList;
    }

    /**
     * Pull SAML metadata from the SAMLSSOConfigServiceImpl and return.
     *
     * @return Populated SAMLMetaData object.
     */
    public SAMLMetaData getSAMLMetadata() {

        SAMLMetaData samlMetaData = new SAMLMetaData();
        samlMetaData.setDefaultNameIdFormat(DEFAULT_NAME_ID_FORMAT);

        try {
            samlMetaData.setCertificateAlias(new MetadataProperty()
                    .defaultValue(DEFAULT_CERTIFICATE_ALIAS)
                    .options(Arrays.asList(samlSSOConfigService.getCertAliasOfPrimaryKeyStore())));
        } catch (IdentityException e) {
            throw handleException(e);
        }

        samlMetaData.setResponseSigningAlgorithm(new MetadataProperty()
                .defaultValue(samlSSOConfigService.getSigningAlgorithmUriByConfig())
                .options(Arrays.asList(samlSSOConfigService.getSigningAlgorithmUris())));

        samlMetaData.setResponseDigestAlgorithm(new MetadataProperty()
                .defaultValue(samlSSOConfigService.getDigestAlgorithmURIByConfig())
                .options(Arrays.asList(samlSSOConfigService.getDigestAlgorithmURIs())));

        samlMetaData.setAssertionEncryptionAlgorithm(new MetadataProperty()
                .defaultValue(samlSSOConfigService.getAssertionEncryptionAlgorithmURIByConfig())
                .options(Arrays.asList(samlSSOConfigService.getAssertionEncryptionAlgorithmURIs())));

        samlMetaData.setKeyEncryptionAlgorithm(new MetadataProperty()
                .defaultValue(samlSSOConfigService.getKeyEncryptionAlgorithmURIByConfig())
                .options(Arrays.asList(samlSSOConfigService.getKeyEncryptionAlgorithmURIs())));

        return samlMetaData;
    }

    /**
     * Pull OAuth/OIDC Metadata from OAuthAdminServiceImpl and return.
     *
     * @return Populated OIDCMetadata object.
     */
    public OIDCMetaData getOIDCMetadata() {

        OIDCMetaData oidcMetaData = new OIDCMetaData();

        List<ClientAuthenticationMethod> supportedClientAuthMethods = new ArrayList<>();
        // 'Select Option' is added to the api until the clearable UI dropdown is implemented
        supportedClientAuthMethods.add(new ClientAuthenticationMethod()
                .name("")
                .displayName(ApplicationManagementConstants.SELECT_OPTION));
        supportedClientAuthMethods.addAll(getClientAuthenticationMethods());
        oidcMetaData.setTokenEndpointAuthMethod(
                new ClientAuthenticationMethodMetadata().options(supportedClientAuthMethods));
        boolean tokenEpAllowReusePvtKeyJwtDefaultValue = Boolean.parseBoolean(IdentityUtil
                .getProperty(ApplicationManagementConstants.TOKEN_EP_ALLOW_REUSE_PVT_KEY_JWT_DEFAULT_VALUE));
        oidcMetaData.setTokenEndpointAllowReusePvtKeyJwt(tokenEpAllowReusePvtKeyJwtDefaultValue);
        List<String> tokenEpSigningAlgorithms = IdentityUtil
                .getPropertyAsList(ApplicationManagementConstants.TOKEN_EP_SIGNATURE_ALGORITHMS_SUPPORTED);
        oidcMetaData.setTokenEndpointSignatureAlgorithm(new MetadataProperty()
                .options(tokenEpSigningAlgorithms));
        List<String> idTokenSigningAlgorithms = new ArrayList<>();
        // 'Select Option' is added to the api until the clearable UI dropdown is implemented
        idTokenSigningAlgorithms.add(ApplicationManagementConstants.SELECT_OPTION);
        idTokenSigningAlgorithms.addAll(IdentityUtil.
                getPropertyAsList(ApplicationManagementConstants.ID_TOKEN_SIGNATURE_ALGORITHMS_SUPPORTED));
        oidcMetaData.setIdTokenSignatureAlgorithm(new MetadataProperty()
                .options(idTokenSigningAlgorithms));
        List<String> requestObjectSigningAlgorithms = new ArrayList<>();
        // 'Select Option' is added to the api until the clearable UI dropdown is implemented
        requestObjectSigningAlgorithms.add(ApplicationManagementConstants.SELECT_OPTION);
        requestObjectSigningAlgorithms.addAll(IdentityUtil
                .getPropertyAsList(ApplicationManagementConstants.REQUEST_OBJECT_SIGNATURE_ALGORITHMS_SUPPORTED));
        oidcMetaData.setRequestObjectSignatureAlgorithm(new MetadataProperty()
                .options(requestObjectSigningAlgorithms));
        List<String> requestObjectEncryptionAlgorithms = new ArrayList<>();
        // 'Select Option' is added to the api until the clearable UI dropdown is implemented
        requestObjectEncryptionAlgorithms.add(ApplicationManagementConstants.SELECT_OPTION);
        requestObjectEncryptionAlgorithms.addAll(IdentityUtil
                .getPropertyAsList(ApplicationManagementConstants.REQUEST_OBJECT_ENCRYPTION_ALGORITHMS_SUPPORTED));
        oidcMetaData.setRequestObjectEncryptionAlgorithm(new MetadataProperty()
                .options(requestObjectEncryptionAlgorithms));
        List<String> requestObjectEncryptionMethods = new ArrayList<>();
        // 'Select Option' is added to the api until the clearable UI dropdown is implemented
        requestObjectEncryptionMethods.add(ApplicationManagementConstants.SELECT_OPTION);
        requestObjectEncryptionMethods.addAll(IdentityUtil
                .getPropertyAsList(ApplicationManagementConstants.REQUEST_OBJECT_ENCRYPTION_METHODS_SUPPORTED));
        oidcMetaData.setRequestObjectEncryptionMethod(new MetadataProperty()
                .options(requestObjectEncryptionMethods));
        List<String> subjectTypes = Arrays.asList(OAuthConstants.SubjectType.PUBLIC.getValue(),
                OAuthConstants.SubjectType.PAIRWISE.getValue());
        oidcMetaData.setSubjectType(new MetadataProperty()
                .defaultValue(IdentityUtil.getProperty(ApplicationManagementConstants.DEFAULT_SUBJECT_TYPE))
                .options(subjectTypes));
        List<String> fapiAllowedSignatureAlgorithms = new ArrayList<>();
        fapiAllowedSignatureAlgorithms.addAll(IdentityUtil
                .getPropertyAsList(ApplicationManagementConstants.FAPI_ALLOWED_SIGNATURE_ALGORITHMS));
        List<String> fapiAllowedEncryptionAlgorithms = new ArrayList<>();
        fapiAllowedEncryptionAlgorithms.addAll(requestObjectEncryptionAlgorithms);
        fapiAllowedEncryptionAlgorithms.removeIf(n -> (n.equals(ApplicationManagementConstants.RSA1_5)));
        List<String> fapiAllowedAuthMethods = new ArrayList<>();
        fapiAllowedAuthMethods.addAll(IdentityUtil
                .getPropertyAsList(ApplicationManagementConstants.FAPI_ALLOWED_CLIENT_AUTHENTICATION_METHODS));
        List<ClientAuthenticationMethod> supportedFapiClientAuthenticationMethods =
                supportedClientAuthMethods.stream().filter(clientAuthenticationMethod ->
                fapiAllowedAuthMethods.contains(clientAuthenticationMethod.getName())).collect(Collectors.toList());
        FapiMetadata fapiMetadata = new FapiMetadata();
        fapiMetadata.allowedFapiProfiles(new MetadataProperty().options(getAllowedFapiProfiles()));
        fapiMetadata.allowedSignatureAlgorithms(new MetadataProperty().options(fapiAllowedSignatureAlgorithms));
        fapiMetadata.allowedEncryptionAlgorithms(new MetadataProperty().options(fapiAllowedEncryptionAlgorithms));
        fapiMetadata.setTokenEndpointAuthMethod(new ClientAuthenticationMethodMetadata()
                .options(supportedFapiClientAuthenticationMethods));
        oidcMetaData.setFapiMetadata(fapiMetadata);
        List<AllowedIssuer> allowedIssuers = getAllowedIssuersForOrganization();
        if (allowedIssuers != null && !allowedIssuers.isEmpty()) {
            oidcMetaData.setAllowedIssuers(allowedIssuers);
        }
        List<String> supportedGrantTypes = new LinkedList<>(Arrays.asList(oAuthAdminService.getAllowedGrantTypes()));
        List<String> publicClientSupportedGrantTypes = Arrays.asList(
                oAuthAdminService.getPublicClientSupportedGrantTypes());
        List<GrantType> supportedGrantTypeNames = new ArrayList<>();
        // Iterate through the standard grant type names and add matching elements.
        for (String supportedGrantTypeName : supportedGrantTypes) {
            GrantType grantType = new GrantType();
            if (getOAuthGrantTypeNames().keySet().contains(supportedGrantTypeName)) {
                grantType.setName(supportedGrantTypeName);
                grantType.setDisplayName(getOAuthGrantTypeNames().get(supportedGrantTypeName));
            } else {
                grantType.setName(supportedGrantTypeName);
                grantType.setDisplayName(supportedGrantTypeName);
            }
            // If the grant type is public client supported, set it as such.
            grantType.setPublicClientAllowed(publicClientSupportedGrantTypes.contains(supportedGrantTypeName));
            supportedGrantTypeNames.add(grantType);
        }
        // Set extracted grant types.
        oidcMetaData.setAllowedGrantTypes(
                new GrantTypeMetaData()
                        .options(supportedGrantTypeNames));

        oidcMetaData.setDefaultUserAccessTokenExpiryTime(
                String.valueOf(oAuthAdminService.getTokenExpiryTimes().getUserAccessTokenExpiryTime()));
        oidcMetaData.defaultApplicationAccessTokenExpiryTime(
                String.valueOf(oAuthAdminService.getTokenExpiryTimes().getApplicationAccessTokenExpiryTime()));
        oidcMetaData.defaultRefreshTokenExpiryTime(
                String.valueOf(oAuthAdminService.getTokenExpiryTimes().getRefreshTokenExpiryTime()));
        oidcMetaData.defaultIdTokenExpiryTime(
                String.valueOf(oAuthAdminService.getTokenExpiryTimes().getIdTokenExpiryTime()));

        OAuthIDTokenAlgorithmDTO idTokenAlgorithmDTO = oAuthAdminService.getSupportedIDTokenAlgorithms();
        oidcMetaData.setIdTokenEncryptionAlgorithm(
                new MetadataProperty()
                        .defaultValue(idTokenAlgorithmDTO.getDefaultIdTokenEncryptionAlgorithm())
                        .options(idTokenAlgorithmDTO.getSupportedIdTokenEncryptionAlgorithms()));
        oidcMetaData.idTokenEncryptionMethod(
                new MetadataProperty()
                        .defaultValue(idTokenAlgorithmDTO.getDefaultIdTokenEncryptionMethod())
                        .options(idTokenAlgorithmDTO.getSupportedIdTokenEncryptionMethods()));

        oidcMetaData.setScopeValidators(
                new MetadataProperty()
                        .defaultValue(null)
                        .options(Arrays.asList(oAuthAdminService.getAllowedScopeValidators())));

        oidcMetaData.accessTokenType(
                new MetadataProperty()
                        .defaultValue(oAuthAdminService.getDefaultTokenType())
                        .options(oAuthAdminService.getSupportedTokenTypes()));
        List<TokenBindingMetaDataDTO> supportedTokenBindings = oAuthAdminService.getSupportedTokenBindingsMetaData();
        List<String> supportedTokenBindingTypes = new ArrayList<>();
        supportedTokenBindingTypes.add("None");
        for (TokenBindingMetaDataDTO tokenBindingDTO : supportedTokenBindings) {
            supportedTokenBindingTypes.add(tokenBindingDTO.getTokenBindingType());
        }
        oidcMetaData.setAccessTokenBindingType(
                new MetadataProperty()
                        .defaultValue("None")
                        .options(supportedTokenBindingTypes));
        List<String> supportedNotificationChannels = cibaAuthService.getSupportedNotificationChannels();
        CIBAMetadata cibaMetadata = new CIBAMetadata();
        for (String notificationChannel : supportedNotificationChannels) {
            CIBANotificationChannel ciBANotificationChannel = new CIBANotificationChannel();
            ciBANotificationChannel.setName(notificationChannel);
            ciBANotificationChannel.setDisplayName(getCibaNotificationChannelNames().getOrDefault(notificationChannel,
                    notificationChannel));
            cibaMetadata.addSupportedNotificationChannelsItem(ciBANotificationChannel);
        }
        oidcMetaData.cibaMetadata(cibaMetadata);
        return oidcMetaData;
    }

    /**
     * Pull WS Trust metadata from STSAdminServiceInterface and return.
     *
     * @return Populated WSTrustMetadata object.
     */
    public WSTrustMetaData getWSTrustMetadata() {

        WSTrustMetaData wsTrustMetaData = new WSTrustMetaData();
        try {
            // Check if WS-Trust is deployed.
            if (sTSAdminServiceInterface != null) {
                wsTrustMetaData.setCertificateAlias(new MetadataProperty()
                        .defaultValue(null)
                        .options(Arrays.asList(sTSAdminServiceInterface.getCertAliasOfPrimaryKeyStore())));
            } else {
                throw new SecurityConfigException(ERROR_WS_TRUST_METADATA_SERVICE_NOT_FOUND.getDescription());
            }
        } catch (SecurityConfigException e) {
            if (e.getMessage().equals(ERROR_WS_TRUST_METADATA_SERVICE_NOT_FOUND.getDescription())) {
                // Throw 404 error since the WS-Trust connector is not available.
                throw handleNotFoundError(e);
            } else {
                throw handleException(e);
            }
        }
        return wsTrustMetaData;
    }

    /**
     * Pull property metadata of the custom inbound protocol that matches to the protocol name.
     *
     * @param inboundProtocolName URL encoded protocol name.
     * @return Populated CustomInboundProtocolMetaData object.
     */
    public CustomInboundProtocolMetaData getCustomProtocolMetadata(String inboundProtocolName) {

        String protocolName = URLDecoder.decode(inboundProtocolName);
        Map<String, AbstractInboundAuthenticatorConfig> allCustomAuthenticators = applicationManagementService
                        .getAllInboundAuthenticatorConfig();

        // Loop through all custom inbound protocols and match the name.
        for (Map.Entry<String, AbstractInboundAuthenticatorConfig> entry : allCustomAuthenticators
                .entrySet()) {
            if (entry.getValue().getName().equals(protocolName)) {
                return new CustomInboundProtocolMetaData()
                        .displayName(entry.getValue().getFriendlyName())
                        .configName(entry.getValue().getConfigName())
                        .properties(getCustomInboundProtocolProperties(entry.getValue().getConfigurationProperties()));
            }
        }

        // Throw 404 error if the protocol not found
        throw handleInvalidInboundProtocol(inboundProtocolName);
    }

    /**
     * Loop through all protocol properties and create a list of CustomInboundProtocolProperty objects.
     *
     * @param properties Custom inbound protocol properties.
     * @return Populated property list.
     */
    private List<CustomInboundProtocolProperty> getCustomInboundProtocolProperties(Property[] properties) {

        List<CustomInboundProtocolProperty> protocolProperties = new ArrayList<>();
        for (Property property : properties) {
            CustomInboundProtocolProperty protocolProperty = new CustomInboundProtocolProperty();

            if (StringUtils.isNotBlank(property.getName())) {
                protocolProperty.setName(property.getName());
            }
            if (StringUtils.isNotBlank(property.getDisplayName())) {
                protocolProperty.setDisplayName(property.getDisplayName());
            }
            if (StringUtils.isNotBlank(property.getType())) {
                protocolProperty.setType(CustomInboundProtocolProperty.TypeEnum.valueOf(
                        property.getType().toUpperCase(Locale.ENGLISH)));
            } else {
                protocolProperty.setType(CustomInboundProtocolProperty.TypeEnum.STRING);
            }
            protocolProperty.setRequired(property.isRequired());
            if (property.getOptions() != null) {
                protocolProperty.setAvailableValues(Arrays.asList(property.getOptions()));
            }
            if (StringUtils.isNotBlank(property.getDefaultValue())) {
                protocolProperty.setDefaultValue(property.getDefaultValue());
            }
            if (StringUtils.isNotBlank(property.getRegex())) {
                protocolProperty.setValidationRegex(property.getRegex());
            }
            protocolProperty.setDisplayOrder(property.getDisplayOrder());
            protocolProperty.setIsConfidential(property.isConfidential());

            protocolProperties.add(protocolProperty);
        }
        return protocolProperties;
    }

    public AdaptiveAuthTemplates getAdaptiveAuthTemplates() {

        AdaptiveAuthTemplates adaptiveAuthTemplates = new AdaptiveAuthTemplates();
        adaptiveAuthTemplates.setTemplatesJSON(applicationManagementService.getAuthenticationTemplatesJSON());
        return adaptiveAuthTemplates;
    }

    /**
     * If the passed exception has an error message, set it to the description of the API error response.
     *
     * @param e Exception caught.
     * @return APIError with exception error message if present.
     */
    private APIError handleException(Exception e) {

        ErrorMessage errorEnum = ERROR_RETRIEVING_SAML_METADATA;
        String description = errorEnum.getDescription();
        if (StringUtils.isNotBlank(e.getMessage())) {
            description = e.getMessage();
        }

        return Utils.buildServerError(errorEnum.getCode(), errorEnum.getMessage(), description, e);
    }

    /**
     * Extract the required arguments and build a not found error.
     *
     * @param e Exception caught.
     * @return APIError with exception code, message and description.
     */
    private APIError handleNotFoundError(Exception e) {

        ErrorMessage errorEnum = ERROR_WS_TRUST_METADATA_SERVICE_NOT_FOUND;
        String errorCode = errorEnum.getCode();
        String errorMessage = errorEnum.getMessage();
        String errorDescription = e.getMessage();

        return Utils.buildNotFoundError(errorCode, errorMessage, errorDescription);
    }

    private APIError handleInvalidInboundProtocol(String inboundName) {

        String errorCode = ErrorMessage.INVALID_INBOUND_PROTOCOL.getCode();
        String errorMessage = ErrorMessage.INVALID_INBOUND_PROTOCOL.getMessage();
        String errorDescription = String.format(ErrorMessage.INVALID_INBOUND_PROTOCOL.getDescription(), inboundName);

        return Utils.buildClientError(errorCode, errorMessage, errorDescription);
    }

    private List<ClientAuthenticationMethod> getClientAuthenticationMethods() {

        HashSet<ClientAuthenticationMethodModel> tokenEpAuthMethods = OAuth2Util.getSupportedAuthenticationMethods();
        List<ClientAuthenticationMethod> supportedClientAuthMethods = new ArrayList<>();
        for (ClientAuthenticationMethodModel authMethod : tokenEpAuthMethods) {
            ClientAuthenticationMethod clientAuthenticationMethod = new ClientAuthenticationMethod();
            clientAuthenticationMethod.setName(authMethod.getName());
            clientAuthenticationMethod.setDisplayName(authMethod.getDisplayName());
            supportedClientAuthMethods.add(clientAuthenticationMethod);
        }
        return supportedClientAuthMethods;
    }

    private List<AllowedIssuer> getAllowedIssuersForOrganization() {

        OAuth2OIDCConfigOrgUsageScopeMgtService oauth2OIDCConfigOrgUsageScopeMgtService =
                ApplicationManagementServiceHolder.getOAuth2OIDCConfigOrgUsageScopeMgtService();
        List<AllowedIssuer> allowedIssuers = new ArrayList<>();
        try {
            List<IssuerDetails> issuerDetailsList = oauth2OIDCConfigOrgUsageScopeMgtService.getAllowedIssuerDetails();
            if (issuerDetailsList == null || issuerDetailsList.isEmpty()) {
                return null;
            }

            for (IssuerDetails issuer : issuerDetailsList) {
                AllowedIssuer allowedIssuer = new AllowedIssuer();
                allowedIssuer.setValue(issuer.getIssuer());
                allowedIssuer.setOrganizationId(issuer.getIssuerOrgId());
                allowedIssuer.setTenantDomain(issuer.getIssuerTenantDomain());
                allowedIssuers.add(allowedIssuer);
            }
            return allowedIssuers;
        } catch (OAuth2OIDCConfigOrgUsageScopeMgtException e) {
            throw handleServerError(ERROR_RETRIEVING_ALLOWED_ISSUERS, e);
        }
    }

    /**
     * Retrieves the list of allowed FAPI profiles for the current tenant from FapiConfigMgtService.
     * Returns an empty list if the service is unavailable or no profiles are configured.
     *
     * @return List of allowed FAPI profile string values.
     */
    private List<String> getAllowedFapiProfiles() {

        if (fapiConfigMgtService == null) {
            LOG.debug("FapiConfigMgtService is not available. Returning empty FAPI profiles list.");
            return Collections.emptyList();
        }
        String tenantDomain = ContextLoader.getTenantDomainFromContext();
        try {
            FapiConfig fapiConfig = fapiConfigMgtService.getFapiConfig(tenantDomain);
            List<FapiProfileEnum> supportedProfiles = fapiConfig.getSupportedProfiles();
            if (CollectionUtils.isEmpty(supportedProfiles)) {
                return Collections.emptyList();
            }
            return supportedProfiles.stream()
                    .map(FapiProfileEnum::value)
                    .collect(Collectors.toList());
        } catch (FapiConfigMgtException e) {
            throw handleServerError(ErrorMessage.ERROR_RETRIEVING_FAPI_METADATA, e);
        }
    }

    /**
     * Handles the server errors and build APIError response with the given error message and exception.
     *
     * @param errorMessageEnum Error message enum to get the error code and message for the response.
     * @param e Exception caught.
     * @return APIError with exception code, message and description.
     */
    private APIError handleServerError(ErrorMessage errorMessageEnum, Exception e) {

        String errorCode = errorMessageEnum.getCode();
        String errorMessage = errorMessageEnum.getMessage();
        String errorDescription = e.getMessage();

        return Utils.buildServerError(errorCode, errorMessage, errorDescription, e);
    }
}
