Before You Begin with Oracle Messaging Cloud Service

Prior to using Oracle Messaging Cloud Service, ensure you are familiar with the following:

  • Oracle Cloud

    Create and configure your account on Oracle Cloud. For more information about creating an account on Oracle Cloud, see How to Begin with Oracle Messaging Cloud Service Subscriptions.

  • Java library

    The Java library is included in the Oracle Messaging Cloud Service Java SDK that can be downloaded from Oracle Technology Network. To download the Java SDK, see Downloading the Oracle Messaging Cloud Service Java SDK.

    The Java library requires a Java Development Kit (JDK) of version 1.6 or greater for compiling your applications.

    To use the Java library, you must have connectivity to the public Internet.

    The JMS 1.1 API JAR file is also required to compile your web applications. To download the JAR file, accept the Software License Agreement and click on the download link available at following URL:


    To use the Oracle Messaging Cloud Service REST API, you must have connectivity to the public Internet.

    You should have a strong understanding of the HTTP request/response protocol, specifically:

    • How HTTP cookies are used in response and request headers and when a given cookie is to be included in a request to a particular URL

    • How to read and manipulate HTTP headers and query string parameters

  • Message Push Listeners

    If you are using message push listeners to send messages to user-defined URLs, you must have an HTTP server that is reachable from the public Internet and addressable at the provided URL. You must also have the ability to deploy custom applications to the user-defined URL to first verify ownership of the provided URL and then receive messages.

    If you are pushing messages to a user-defined URL over HTTPS, the push target must have a valid Secure Sockets Layer (SSL) certification from Verisign. Communication from Oracle Cloud to external hosts with invalid SSL certificates or self-signed certificates will fail.

Before developing applications that use Oracle Messaging Cloud Service, make sure you understand the following and adhere to the guidelines documented in the relevant sections:


    The Oracle Messaging Cloud Service REST API relies on the use of JSESSIONID HTTP cookies to identify and reuse messaging contexts between REST API HTTP requests. Each service instance has a quota of connections that can be created, so it is important to manage messaging contexts, and their associated connections and cookies. For guidelines on using JSESSIONID HTTP cookies, see Messaging Context and HTTP Cookies.

  • Cross-Site Request Forgery (CSRF) prevention

    CSRF is an HTTP client vulnerability in which malicious code attempts to exploit a web server's trust in a user's identity (represented by an HTTP cookie). For information about how Oracle Messaging Cloud Service prevents CSRF attacks and how to manage anti-CSRF tokens generated for connections, see Cross-Site Request Forgery (CSRF) Prevention.

For additional considerations when developing applications with the Oracle Messaging Cloud Service Java library and REST API, see Developing Applications That Use Oracle Messaging Cloud Service.