We're excited to share a new Tophhie Cloud API with you, again we're making this one publicly available without authentication and freely available to all.

So, without further ado... I introduce the...

Entra ID - ID Converter API 🎉

This API is quite simple. There's not much complexity to it, but we've found it useful when configuring local security groups on Windows devices, or when we needed to determine which object in Entra ID relates to a SID in Windows.

It allows you to convert an Entra ID Object ID to a SID, or vice versa, a SID to an Entra ID Object ID.

The API is available from this endpoint:
https://api.tophhie.cloud/entra/convertid

To utilise the API, you'll need one of the following:

• An Entra ID Object ID
  • this can be for any object within the tenant; user, group, device, role, etc.
• The SID (security identifier)

Once you have either the object ID or SID, you're ready to use this API.

All you need to do is append the data to the end of the API endpoint URL.

For example, if you had an object ID:
https://api.tophhie.cloud/entra/convertid/d35aaeb0-fef1-4f6a-894d-ded53af567d5

Or, if you had a SID:
https://api.tophhie.cloud/entra/convertid/S-1-12-1-3545935536-1332412145-3588115849-3580359994

Once you call the API, you'll receive either a JSON object response (if the request is successful) or a standard text response with an error message.

The success response will always have a 200 status code.

The successful JSON object will look like:

{
  "originalId": string,
  "returnId": string,
  "convertDirection": string,
  "support": {
    "message": string,
    "email": string
  }
}

The originalId will be the ID you provided the API.
The returnId will be the converted ID.
The convertDirection will indicate in which way the ID was converted.
The support object provides you with contact information for Tophhie Cloud API support.

Any status other than 200, means there was an error, and the text will indicate what the error was.

And there you have it, a simple Entra ID - ID Converter! Feel free to give it a try and let me know what you think. As always, you can reach our API support email address at api-support@tophhie.cloud.

Until next time 👋