Microsoft Active Directory

Configure and use the OneFuse Microsoft Active Directory module with the Python module

  2 minute read  

To learn more about this OneFuse module, refer to Microsoft Active Directory.

Prerequisites

  1. Configure OneFuse Manager
  2. Review an overview on OneFuse Modules with OneFuse Python Module

Provision

Register a Computer Account in Microsoft Active Directory for a resource.

Method

#Run the following in the Python Console
#Assumes OneFuse Manager is instantiated to 'ofm' variable

ofm.provision_ad('<policy_name>', <template_properties>, '<name>', '<tracking_id>')

Parameter references

The following defines the function of each Microsoft Active Directory specific Parameters.

Parameter Name Required? Notes
policy_name Required OneFuse Module Policy Name (string).
template_properties Optional Additional properties that are referenced within the Policy. Python dict format.
tracking_id Optional Tracking ID (string) to link multiple OneFuse Policy Executions and resulting OneFuse Managed Objects together. If none is passed, one gets generated by OneFuse for that specific Policy Execution. (See OneFuse Python Module Tracking ID Methods below.)

OneFuse Python Module Tracking ID Methods:

Method Name Notes
create_tracking_id() Generate a unique Tracking ID to link OneFuse Policy Executions and the resulting Managed Objects together.
get_tracking_id_from_mo('<Path to OneFuse Managed Object>') Get the Tracking ID from a OneFuse Managed Object.
add_tracking_id_to_headers('<Tracking ID>') Add Tracking ID into request headers. When making custom requests to OneFuse instead of using OneFuse Python Module methods provided.

Learn more about OneFuse Tracking ID.

Microsoft Active Directory specific Parameters:

Parameter Name Required? Notes
name Required Computer Account Name

Update: Move OU

Move the Computer Account from the Build OU to final OU for a resource.

Method

#Run the following in the Python Console
#Assumes OneFuse Manager is instantiated to 'ofm' variable

ofm.move_ou('<ad_id>')

Parameter references

The following defines the function of the method Parameter.

Parameter Name Required? Notes
ad_id Required ID of the OneFuse Microsoft Active Directory Computer Account Managed Object

Deprovision

Delete a Computer Account from Microsoft Active Directory for a resource.

Method

#Run the following in the Python Console
#Assumes OneFuse Manager is instantiated to 'ofm' variable

ofm.deprovision_ad('<ad_id>')

Parameter references

The following defines the function of the method Parameter.

Parameter Name Required? Notes
ad_id Required ID of the OneFuse Microsoft Active Directory Computer Account Managed Object