The information in this wiki hasn't been maintained for a good while. Some of the projects described have since been deprecated.

In particular, the "Ushahidi Platform v3.x" section contains information that is often misleading. Many details about this version of Platform have changed since.

This website is an extraction of the original Ushahidi wiki into a static form. Because of that, functions like logging in, commenting or searching will not work.

For more documentation, please refer to

Skip to end of metadata
Go to start of metadata


CrowdmapID is Ushahidi's centralized authentication service. It provides a sign sign on account usable on Crowdmap, Swift, and Ushahidi deployments that opt in to using the service.


How to change your login:



CrowdmapID is a simple authentication and identity management system that provides users with a secure central sign-on facility.


Built for PHP 5.3+. Requires a MySQL 5.1+ and Memcached server. You can optionally send mail using the API, if you have an account.

API Versions

CrowdmapID currently supports the v1.0 API, which is backwards compatible with RiverID.


  1. Create a MySQL database.
  2. Run the create_database.sql file on the database.
  3. Copy the contents of config.example.php and paste it into a new file called config.php
  4. Modify the relevant settings.
  5. Add an application to the database, since all calls must have an accompanying API key. Here's an example: sql INSERT INTO `applications` (`id`, `name`, `url`, `secret`, `ratelimit`, `mail_from`, `note`, `admin_email`, `admin_identity`, `debug`, `registered`, `admin_access`) VALUES (1, 'App Name', '', 'B07E6009296E90C0ABE480B828241212300172B10CA60B8B0063BAD56C1B2222', 0, '', '', '', 'Some Company Name', 0, NOW(), 0); The important field here is the secret key. Once this is in the table, you can hit your new API. Example URL: