Authenticating users

If you are programmatically accessing the OpenX API, you must provide a method to authenticate a user. The OpenX API uses OAuth 1.0 to authenticate users. The following explains your options.

Your Authentication Options

You can programmatically authenticate an OpenX user in one of three ways:

  • (Recommended) Use the client libraries provided by OpenX.

  • (Recommended) Use a third-party library that already implements an OAuth 1.0 scheme. Note that OpenX does not support or manage the content of these libraries.

  • Write your own authentication code. OpenX provides a brief OAuth reference for those who want to take this approach.

Credentials Supplied by OpenX

When you become an API customer, OpenX provides you with the following credentials which you will use in initial authentication calls.

Credentials Supplied by OpenX

Parameter Description
Username Your account username provided by your account manager
Password Your account password provided by your account manager
Consumer Key The ID portion of your Consumer credentials, provided by your account manager
Consumer Secret The Consumer secret can be thought of as the password for the Consumer credentials. This is also provided by your account manager
OAuth Realm The realm value is a string, generally assigned by the origin server. In this case, the realm parameter is used for your OpenX server instance. For example, OAuth realm=""