Using the Management Portal¶

The Chatmongers Management Portal allows you to manage your XMPP domains, XMPP users, administrative users, and more.

Concepts and Vocabulary¶

Organization: A logical container which XMPP domains and administrative users can be associated with
XMPP Domain: This is usually displayed as an FQDN and represents all of the parts that comprise a chat domain or chat system. There are DNS records, XMPP users, and usage statistics associated with each XMPP Domain
XMPP User: XMPP users are created with and belong to a single XMPP domain. XMPP users are identified by their JID
DNS Domain: This section of the Organization management page allows you to setup and use your own domain names with the Chatmongers Cloud.
SRV Record: SRV records are a type of DNS record that allow clients to dynamically resolve resources for specific protocols. By specifying XMPP SRV records for a domain, you can enable a client to automatically determine the location of the XMPP servers for a domain.

Managing Your User Account¶

Your user account can be managed via the Account page.

In order to access the API and programmatically manage your resources, you will need to create an API Password. This is done from the Account page.

Authorizing Custom DNS Domains¶

In order to use your own domain name with the Chatmongers Cloud, we require that you prove that you control the domain. You can start this process from within your organization’s management page. Under the section “Authorize New Domain” enter the base name of your domain (e.g. example.com).

We will lookup the WHOIS record for the domain and send confirmation emails to the email addresses listed on the record. Follow the link from the email to confirm that you own the domain.

Managing XMPP Domains¶

The starting point for managing XMPP Domains is in the Organization page on the management portal.

Creating new XMPP Domains¶

You can create additional XMPP Domains from your organization’s management page. Simply click “Create” in the “Add XMPP Domain” form to generate a new random four letter chatwith.it subdomain. If you have authorized your own domain for use with the Chatmongers Cloud, you can enter a subdomain in the text box and choose one of your domains.

Configuring Authentication Methods¶

The Chatmongers Cloud can utitlize your existing systems to authenticate users.

External POP3¶

Coming soon

The Chatmongers Cloud can also authenticate your users against your email system.

Host: the hostname or IP address of your POP3 server
Port: the TCP port to use, default is 110
Use SSL: always use SSL for this connection
Append Domain: the domain name to use for authentication, if different from the domain name in the XMPP JID
Cache TTL: the length of time to cache a response, default it 120 seconds

External Webservice¶

Coming soon

Chatmongers Cloud can authenticate users against your own HTTP API.

URL: the full URL where your API can be reached
Secret: the shared secret used to access your API
Cache TTL: the length of time to cache a response, default it 120 seconds

For information about the webservice requirements please see, please see external-auth-webservice.

Managing XMPP Users¶

The domain configuration page in the management portal displays a list of all users in your domain. You can edit, delete, or add users to your domain.