=========================== Using the Management Portal =========================== The `Chatmongers Management Portal `_ allows you to manage your XMPP domains, XMPP users, administrative users, and more. .. index:: Glossary .. index:: Concepts and Vocabulary 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. .. index:: DNS Domains 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. .. index:: External Authentication .. index:: External Authentication; POP3 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 .. index:: External Authentication; Webservice 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 :ref:`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.