Log in to Enterprise Hosted

If you want to log in directly to a hosted account or multiple hosted accounts, you still use the login action, but you need to specify an account ID or domain name, in addition to the user's login ID and password. You can specify a domain name if you want to avoid sending an account ID over the Internet.

With a hosted account, you cannot use single sign-on or external authentication. You must pass the user's authentication credentials on Enterprise Hosted, not the credentials for an external network.

NOTE

 

It is important to have SSL enabled on your Enterprise Hosted account, because you are sending user IDs, passwords, and account information over the Internet to your account hosted at Adobe.

Log in to Enterprise Hosted with an account ID

  1. Before you log the user in, call common-info with the domain name of your hosted account in either the request URL or the domain parameter:
    http://acme.adobe.com/api/xml?action=common-info
    http://adobe.com/api/xml?action=common-info&domain=acme.adobe.com
    
  2. Parse the response for the values of cookie and account-id:
    <cookie>Sbreezzd2dfr2ua5gscogv</cookie> 
    ...
    <account account-id="295153" /> 
    
  3. Collect the user's login ID and password in your application.
  4. Call the login action, adding the user's credentials and the account-id and session parameters:
    https://example.com/api/xml?action=login&login=joy@acme.com
        &password=happy&account-id=295153&session=Sbreezzd2dfr2ua5gscogv
    
  5. Parse the response for a status code of ok.
  6. (Optional) If you prefer, you can call login before common-info, extract the cookie value from the response header, and manage it yourself or using a cookie management library. For details, see "Log in with cookie management" or "Log in using the session parameter."

Log in to Enterprise Hosted with a domain name

  1. Before you log the user in, call common-info with the domain name of your hosted account in either the request URL or the domain parameter:
    http://acme.adobe.com/api/xml?action=common-info
    http://adobe.com/api/xml?action=common-info&domain=acme.adobe.com
    
  2. Parse the response for the values of cookie and host:
    <cookie>breezxq66rt43poai3if8</cookie>
    ...
    <host>https://acme.adobe.com</host>
    
  3. Extract the domain name from the value of host:
    acme.adobe.com
    
  4. In your application, collect the user's login ID and password.

    Be sure the login ID is the user's Enterprise Hosted login ID, not an external one.

  5. Call login, adding the user's credentials and the domain and session parameters:
    https://example.com/api/xml?action=login&login=joe
        &password=smith99&domain=acme.adobe.com&session=breezxq66rt43poai3if8
    

    The domain is equivalent to the account-id, but by using it you can avoid sending an account ID over the Internet, especially if you use a non-encrypted connection.

  6. Parse the response for a status code of ok.
  7. (Optional) If you prefer, you can call login before common-info, extract the cookie value from the response header, and manage it yourself or using a cookie management code library. For details, see "Log in with cookie management" or "Log in using the session parameter."


Take a survey


 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/breeze/6/xml_api/02_logi4.htm