¶ Create an application

This document is automatically generated based on https://github.com/authing/authing-docs-factory and https://api-explorer.genauth.ai V3 API, and is consistent with API parameters and return results. If this document description is incorrect, please refer to V3 API.

Create an application

¶ Method Name

ManagementClient.createApplication

¶ Request Parameters

¶ Sample Code

package test.management;

import cn.authing.sdk.java.client.ManagementClient;
import cn.authing.sdk.java.dto.ApplicationPaginatedRespDto;
import cn.authing.sdk.java.dto.CreateApplicationDto;
import cn.authing.sdk.java.model.ManagementClientOptions;
import cn.authing.sdk.java.util.JsonUtils;

public class CreateApplicationTest {
    // Need to be replaced with your GenAuth Access Key ID
    private static final String ACCESS_KEY_ID = "AUTHING_ACCESS_KEY_ID";
    // Need to be replaced with your GenAuth Access Key Secret
    private static final String ACCESS_KEY_SECRET = "AUTHING_ACCESS_KEY_SECRET";

    public static void main(String[] args) throws Throwable {
        ManagementClientOptions clientOptions = new ManagementClientOptions();
        clientOptions.setAccessKeyId(ACCESS_KEY_ID);
        clientOptions.setAccessKeySecret(ACCESS_KEY_SECRET);
        // If you are a private deployment customer, you need to set the GenAuth service domain name
        // clientOptions.setHost("https://api.your-authing-service.com");

        ManagementClient client = new ManagementClient(clientOptions);

        CreateApplicationDto reqDto = new CreateApplicationDto();
        reqDto.setAppName("Demo");
        reqDto.setAppIdentifier("example");
        ApplicationPaginatedRespDto response = client.createApplication(reqDto);
        System.out.println(JsonUtils.serialize(response));
    }
}

¶ Request Response

Type： CreateApplicationRespDto

Example Results：

{
  "statusCode": 200,
  "message": "Operation successful",
  "requestId": "934108e5-9fbf-4d24-8da1-c330328abd6c",
  "data": {
    "appId": "62eaa95fe0xxxx9a5295bf7c",
    "appIdentifier": "example",
    "appName": "Demo",
    "appLogo": "Demo",
    "appDescription": "Example description",
    "appType": "web",
    "defaultProtocol": "oidc",
    "redirectUris": "[\"https://example.com/callback\"]",
    "logoutRedirectUris": "[\"https://example.com/logout-callback\"]",
    "initLoginUri": "[\"https://example.com/login\"]",
    "ssoEnabled": true,
    "ssoEnabledAt": "2022-07-03T03:20:30.000Z",
    "loginConfig": {
      "enabledBasicLoginMethods": "[\"EMAIL_CODE\",\"EMAIL_PASSWORD\"]",
      "defaultLoginMethod": {
        "connectionType": "QRCODE",
        "qrcodeExtIdpConnId": "6303a2bf2xxxxx7f665f01bf1"
      },
      "enabledExtIdpConns": "[\"6303a2bf2xxxx7f665f01bf1\",\"6321397b6xxxx1b8481ccfc0\"]"
    },
    "registerConfig": {
      "enabledBasicRegisterMethods": "[\"EMAIL_CODE\",\"PHONE_CODE\"]",
      "defaultRegisterMethod": {
        "connectionType": "PASSWORD"
      }
    },
    "brandingConfig": {
      "customCSS": "/* \nEdit login page css\neg：\n.authing-guard-layout {\n  background: black !important;\n}\nChange the background color\n*/",
      "guardVersion": "Advanced",
      "customLoadingImage": "https://files.authing.co/user-contents/photos/cbd51df7-efb1-4b50-b38c-d8e5a04b1830.png",
      "customBackground": "https://files.authing.co/user-contents/photos/cbd51df7-efb1-4b50-b38c-d8e5a04b1830.png",
      "defaultLanguage": "zh-CN",
      "showForgetPasswordButton": true,
      "showEnterpriseConnections": true,
      "showSocialConnections": true,
      "agreements": {
        "displayAt": "[\"LoginPage\",\"RegisterPage\"]",
        "isRequired": true,
        "lang": "zh-CN",
        "content": "I have read and agree to the Privacy Policy and Terms of Service"
      }
    },
    "oidcConfig": {},
    "samlConfig": {},
    "oauthConfig": {},
    "casConfig": {},
    "template": "github"
  }
}

¶ Data Structure

¶ OIDCConfig

¶ SamlIdpConfig

¶ OauthIdpConfig

¶ CasIdPConfig

¶ ApplicationLoginConfigInputDto

¶ ApplicationDefaultLoginMethodInput

¶ ApplicationEnabledExtIdpConnInputDto

¶ ApplicationRegisterConfigInputDto

¶ ApplicationBrandingConfigInputDto

Edit login page css eg: .authing-guard-layout { background: black !important; } Change the background color */| | guardVersion | string | No | Guard version: <br>-Advanced: Advanced version <br>-Classical: Classic version <br> | Advanced | | customLoadingImage | string | No | Custom loading icon, displayed when the login box is loading |https://files.authing.co/user-contents/photos/cbd51df7-efb1-4b50-b38c-d8e5a04b1830.png| | customBackground | string | No | Custom login page background, example: <br>- Image background:url(https://files.authing.co/user-contents/photos/6c6b3726-4a04-4ba7-b686-1a275f81a47a.png) center/cover<br>- Solid color background:rgba(37,49,122,1)<br> |https://files.authing.co/user-contents/photos/cbd51df7-efb1-4b50-b38c-d8e5a04b1830.png| | showChangeLanguageButton | boolean | No | Yes No Show language change button | | | defaultLanguage | string | No | Default language displayed:<br>-zh-CN: Simplified Chinese<br>-zh-TW: Traditional Chinese<br>-en-US: English<br>-ja-JP: Japanese<br><br>By default, the GenAuth login page is automatically rendered based on the user's browser language. <br> | zh-CN | | showForgetPasswordButton | boolean | No | Yes No Show the Forgot Password button |true| | showEnterpriseConnections | boolean | No | Yes No Show enterprise identity source logins |true| | showSocialConnections | boolean | No | Yes No Show social logins |true` |

¶ CreateApplicationRespDataDto

¶ ApplicationLoginConfigDto

¶ ApplicationDefaultLoginMethod

¶ ApplicationEnabledExtIdpConnDto

¶ ApplicationRegisterConfig

¶ ApplicationBrandingConfig

Edit login page css eg: .authing-guard-layout { background: black !important; } Change the background color */| | guardVersion | string | Yes | Guard version: <br>-Advanced: Advanced version <br>-Classical: Classic version <br> | Advanced | | customLoadingImage | string | No | Custom loading icon, displayed when the login box is loading |https://files.authing.co/user-contents/photos/cbd51df7-efb1-4b50-b38c-d8e5a04b1830.png| | customBackground | string | No | Custom login page background, example: <br>- Image background:url(https://files.authing.co/user-contents/photos/6c6b3726-4a04-4ba7-b686-1a275f81a47a.png) center/cover<br>- Solid color background:rgba(37,49,122,1)<br> |https://files.authing.co/user-contents/photos/cbd51df7-efb1-4b50-b38c-d8e5a04b1830.png| | showChangeLanguageButton | boolean | Yes | Yes No Show language change button | | | defaultLanguage | string | Yes | Default language:<br>-zh-CN: Simplified Chinese<br>-zh-TW: Traditional Chinese<br>-en-US: English<br>-ja-JP: Japanese<br> | zh-CN | | showForgetPasswordButton | boolean | Yes | Yes No Show the Forgot Password button |true| | showEnterpriseConnections | boolean | Yes | Yes No Display enterprise identity source login method |true| | showSocialConnections | boolean | Yes | Yes No Display social login method |true` | | showAgreement | boolean | Yes | Yes No Display login and registration agreements | | | agreements | array | Yes | Display login and registration agreement list Nested Type: ApplicationAgreementDto. | |

¶ ApplicationAgreementDto

¶ OIDCConfig

¶ SamlIdpConfig

¶ OauthIdpConfig

¶ CasIdPConfig