Configuring the emm config.json file

Users can change the default functionality related configurations by editing the config.json file that is in the <EMM_HOME>/repository/deployment/server /jaggeryapps/emm/config directory using the information given below. This information is provided as reference for users who are already familiar with the product features and want to know how to configure them. If you need introductory information on a specific concept, such as message receivers and formatters, see the relevant topics in the User Guide. For sample values, see the Example below the table.

appContext
webAgentContex
apiContext
httpsURL
httpURL
enrollmentDir
iOSConfigRoot
iOSAPIRoot
dynamicClientRegistrationEndPoint
adminService
idPServer
callBackUrl
adminUser
usernameLength
ssoConfiguration
- enabled
- issuer
- appName
- identityProviderURL
- responseSigningEnabled
- keyStorePassword
- identityAlias
- keyStoreName
generalConfig
- host
- companyName
- browserTitle
- copyrightText

Property	Description			Data Type	Example
`appContext`	WSO2 EMM has 4 main Jaggery applications, such as emm, emm-web-agent, store and publisher. Depending on the production environment if required these applications can be hosted separately. The emm application is used to manage devices that register with WSO2 EMM. Therefore if you are changing the name of the folder from its default name `emm` the `config.json` file must be updated accordingly.	Yes	N/A	String	/emm/
`webAgentContex`	The `emm-web-agent` Jaggery application is used to handle device enrollments. Therefore if you are changing the name of the folder from its default name `emm-web-agent` the `config.json` file must be updated accordingly.	Yes	N/A	String	/emm-web-agent/
`apiContext`	The api jaggery application contains the API that can be used by users. Therefore if you are changing the name of the folder from its default name api the `config.json` file must be updated accordingly.	Yes	N/A	String	api
`httpsURL`	The HTTPS URL of the hosted EMM server. It should be in the `https://<EMM_HOST>:<EMM_HTTPS_PORT>` format.	Yes	N/A	String	https://10.100.7.98:9443
`httpURL`	The HTTP URL of the hosted EMM server. It should be in the `http://<EMM_HOST>:<EMM_HTTP_PORT>` format.	Yes	N/A	String	https://10.100.7.98:9763
`enrollmentDir`	Provide the path to the directory that handles device enrollment.	Yes	N/A	String	/emm-web-agent/enrollment
`iOSConfigRoot`	The URL path to the iOS enrollment APIs. If the APIs are moved to a different location the `iOSConfigRoot` property must be configured withe the new URL path.	Yes	N/A	String	https://10.100.7.98:9443/ ios-enrollment/
`iOSAPIRoot`	The operations carried out by the iOS devices enrolled with WSO2 EMM are handled via the `ios` APIs. If the APIs are moved from its default location the `iOSAPIRoot` property must be updated accordingly.	Yes	N/A	String	https://10.100.7.98:9443 /ios
`dynamicClientRegistrationEndPoint`	Provide the URL path to access the dynamic client registration endpoint. Dynamic client registration is the mechanisms for dynamically registering OAuth 2.0 clients with the authorization servers.	Yes	N/A	String	https://10.100.7.98:9443 /dynamic-client-web/register/
`adminService`	The URL where the WSO2 carbon is hosted. Some of the requests received by the WSO2 EMM front end will require it to directly call the Carbon components. In a production environment if the UI layer and the carbon layer are hosted in two different locations it will be mandatory for the UI layer to know where the carbon components are hosted.	Yes	N/A	String	https://10.100.7.98:9443
`idPServer`	The IdP server allows users to authenticate against any given identity provider. If your IdP server and the EMM server are hosted in different locations you need to provide the the URL of the separately hosted IdP server.	Yes	N/A	String	https://10.100.7.98:9443
`callBackUrl`	Provide the URL path that contains the backend JAXRSs.	Yes	N/A	String	https://10.100.7.98:9443 /mdm-admin
`adminUser`	Defines the username of the default administrator.	Yes	N/A	String	admin
`usernameLength`	Defines the maximum length of a username.	Yes	N/A	Integer	30
`ssoConfiguration`	Contains the properties that needs to be configured for SSO.	Yes	N/A	ssoConfiguration	-
`generalConfig`	Contains the general configuration properties.	Yes	N/A	generalConfig	-

ssoConfiguration

Property	Description			Data Type	Example
`enabled`	Enable SSO by defining `true` as the value or disable SSO by defining `false` as the value.	Yes	true	Boolean	false
`issuer`	The entity ID of your Identity provider. The default entity ID is mdm but this may change when in a production environment. In such situations you need to configure this field accordingly.	Yes	N/A	String	mdm
`appName`	The client name used to connect to the SSO, IdP.	Yes	N/A	String	admin_emm
`identityProviderURL`	The HTTPS URL of the hosted SSO server.	Yes	N/A	String	https://10.100.7.98:9443 / sso/samlsso.jag
`responseSigningEnabled`	Once response signing is enabled, a SAML response will be signed from the IdP and the client has to validate it using the public key provided by the IdP.	Yes	true	Boolean	false
`keyStorePassword`	Define the password to the keystore. The key store is the repository of security certificates, such as SSL, RA and many more certificates. The default keystore password is `wso2carbon`.	Yes	wso2carbon	String	keyStore_password
`identityAlias`	Provide the public certificate alias of wso2carbon.jks.	Yes	N/A	String	wso2carbon
`keyStoreName`	Define the location and the name of keystore. WSO2 Carbon-based products are shipped with a default keystore named wso2carbon.jks, which is stored in the `<PRODUCT_HOME>/repository/resources/security` directory.	Yes	/repository/resources/security/wso2carbon.jks	String	-

generalConfig

Property	Description			Data Type	Example
`host`	Provide the HTTPS URL of the running EMM server.	Yes	N/A	String	https://localhost:9443
`companyName`	Provide your Organization name.	Yes	N/A	String	WSO2 Enterprise Mobility Manager
`browserTitle`	Provide the content that must be appear on the browser title.	Yes	N/A	String	WSO2 EMM
`copyrightText`	Provide the copyright text.	Yes	N/A	String	\u00A9 %date-year%, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.

Example

{
    "appContext" : "/emm/",
    "webAgentContext" : "/emm-web-agent/",
    "apiContext" : "api",
    "httpsURL" : "%https.ip%",
    "httpURL" : "%http.ip%",
    "enrollmentDir": "/emm-web-agent/enrollment",
    "iOSConfigRoot" : "%https.ip%/ios-enrollment/",
    "iOSAPIRoot" : "%https.ip%/ios/",
    "dynamicClientRegistrationEndPoint" : "%https.ip%/dynamic-client-web/register/",
    "adminService":"%https.ip%",
    "idPServer":"%https.ip%",
    "callBackUrl":"%https.ip%/mdm-admin",
    "adminUser":"admin",
    "usernameLength":30,
    "ssoConfiguration" : {
        "enabled" : false,
        "issuer" : "mdm",
        "appName" : "admin_emm",
        "identityProviderURL" : "%https.ip%/sso/samlsso.jag",
        "responseSigningEnabled" : "true",
        "keyStorePassword" : "wso2carbon",
        "identityAlias" : "wso2carbon",
        "keyStoreName" : "/repository/resources/security/wso2carbon.jks"
    },
    "generalConfig" : {
        "host" : "https://localhost:9443",
        "companyName" : "WSO2 Enterprise Mobility Manager",
        "browserTitle" : "WSO2 EMM",
        "copyrightText" : "\u00A9 %date-year%, WSO2 Inc. (http://www.wso2.org) All Rights Reserved."
    }
}