GX Technology : APIs - Internal - About

Client Configuration

GET /axis/about/v1/client/configuration

Provides details so the client may configure itself.

Response

HTTP 200
NameTypeRequiredDescription
encryptionEnabledBooleanYesFlag indicating if client/server encryption is enabled or not
encryptionMapNoMap of client/server encryption settings. Required if encryptionEnabled is set to true
encryption.algorithmStringYes

The encryption algorithm to employ

encryption.versionStringYesThe version identifier of the encryption configuration in use
HTTP 500

Indicates an internal server error has occurred.

Example Response

{
	"success": true,
	"message": null,
	"configurations": {
		"encryptionEnabled": true,
		"encryption": {
			"version": "v1",
			"algorithm": "AES-CBC-256"
		}
	}
}

Public Key

GET /axis/about/v1/publickey

Returns the public key used to securely exchange client/server encryption keys.

Response

HTTP 200
NameTypeRequiredDescription
publicKeyMapYesMap of public key values
publicKey.pemStringYesThe PEM encoded public key
publicKey.algorithmStringYesThe encryption algorithm to employ
publicKey.versionStringYesThe version identifier of the encryption configuration in use
HTTP 401

Indicates that the user is not logged in.

HTTP 500

Indicates that an internal server error has occurred.

Example Response

{
	"success": true,
	"message": null,
	"publicKey": {
		"pem": "-----BEGIN PUBLIC KEY-----\n[BASE64 ENCODED DATA]\n-----END PUBLIC KEY-----",
		"version": "v1",
		"algorithm": "RSA-OAEP"
	}
}