Introduction

These are a set of utilities to assist administrators support their instance.

Features at a Glance

Features in Detail

External Directory Sync Rest Interface

Description

This is a rest interface to trigger the synchronization of all of the external directories. It will not restart a sync is one is already underway for that directory.

URL: <bitbucket-url>/rest/bitbucket-support/1.0/directory/sync Input Parameters: none

Note, this interface does not check for any credentials. Therefore a simple get call to the url will trigger the sync. From a security perspective, this would allow somebody to learn the names of the external directories as defined within Bitbucket. As it will only start a sync that Bitbucket is doing anyway on a regular basis there did not seem to be much value in trying to protect this operation and not protecting it made it easier to integrate with a self registration system and not have to worry about password synchronization.

Usage

Use a web browser, curl, or something like get go query the url at <bitbucket-url>/rest/bitbucket-support/1.0/directory/sync

Purpose

In order to avoid a manual process for granting users a license in Bitbucket, we put together a website where users could enter their Active Directory credentials and be added to the AD group with permissions. We use this rest interface to trigger a sync when a user was added to one of the special groups.

Home