Friday, October 23, 2009

Understanding the Nimbits SOA Key

Please note we are phasing out SOA Key's in favor of OAuth. Please contract me if you have any questions - bsautner@ google's free mail service.

This blog posting will help you understand how to access your private Nimbits historical data using a SOA key instead of your google account. Please note you can always make your points public so anyone can see the data and make it much easier to access. See my other posts on sharing your data if that interests you.

When you log into Nimbits with your Google Account, you have access to all of your historical data and applications. However, we need to provide you with a way to tell the nimbits system who you are when your using or developing an application that dosn't have the ability to provide Google account information. The solution is your SOA key.

When you log into app.nimbits.com you can create a SOA key which is a random 64 character string like this:

drGcVC5mJOLiCDEFAIKf288yCDighMKtq02mzy0oT0aSiP1vscLlaHABT4GInFmC

just click the Manage SOA Key Menu and you'll be prompted to either rest your key to a new one or to have your current key emailed to you. Your key will be emailed to the Google account you're logged in with.

You should keep this key as safe as you keep your google account password since it can be used to read and write values to your data points. In order to do more advanced things like delete data or create points, you need to log into the application normally.

If you feel you need a new key, just use the menu to generate a new one. The old key will no longer work. Keep this in mind since any apps or spreadsheets you have will need to have their key updated.

Using a SOA key extends your ability to access your Nimbits data from apps outside the Google environment. Read more in this blog about making your data points public so they can be accessed without a key by anyone anywhere (for those of you who don't care who knows what the current humidity level of your humidor is but still want to give your facebook friends hourly updated :-)

Read more on this blog about using your SOA Key in a .net or java application to use nimbit.com as a data source.


No comments:

Post a Comment