Getting Started

Want to add Pilot to your service? Great! Here’s how to get started.

Preliminaries

Before adding Pilot, make sure that your service uses the following:

  • SSO (preferably SAML)

Hello Pilot

Let’s start with something simple. Run the command

1
2
3
4
5
6
7
$ echo "
<html>
  <body>
    $(curl -H 'X-Auth-Token: 12345' \
        "https://prod.pilot.api.rackspacecloud.com/v1/cloud/01/navigation")
  </body>
</html>" > pilot-hello-world.html

and then open the generated pilot-hello-world.html in a browser. It should look something like

_images/new_nav.png

So how did this work? Lines 4–5 make a Pilot request of the form

$ curl -H "X-Auth-Token: $TOKEN" \
    "https://pilot.api.rackspacecloud.com/v1/cloud/$TENANT/navigation"

where $TENANT is a user’s tenant id and $TOKEN is an authentication token returned by Identity for that user. In our case, we supplied gibberish for these values, so Pilot responded with a default header, which is returned whenever an error occurs. Our command combined the HTML/JS/CSS fragment returned by Pilot to produce pilot-hello-world.html.