Retrieving AD Groups

From DreamFactory
Jump to: navigation, search
DreamFactoryTutorialsRetrieving AD Groups
(Example - Get specific Group information.)
(Example - Getting list of Groups by Active Directory Username.)
Line 31: Line 31:
 
<pre>GET http://foo.com/api/v2/ad/group/DreamFactory</pre>
 
<pre>GET http://foo.com/api/v2/ad/group/DreamFactory</pre>
  
=== Example - Getting list of Groups by Active Directory Username. ===
+
=== Example - Get list of Groups by Active Directory Username ===
 
* Service name: ad
 
* Service name: ad
 
* Active Directory Username: jdoe
 
* Active Directory Username: jdoe

Revision as of 16:28, 15 July 2016

Tutorial

DreamFactory's Active Directory service allows you to retrieve your Active Directory Groups using the 'group' resource.

This tutorial focuses on retrieving Active Directory Groups using an existing DreamFactory Active Directory service. To learn how to se tup an Active Directory service see Using Active Directory.

API Endpoints

  • To get a list of all Active Directory Groups and their details.
GET http://{url}/api/v2/{ad_service}/group
  • To get details about a specific Group.
GET http://{url}/api/v2/{ad_service}/group/{group_name}

Example - Get list of all Active Directory Groups with all fields

  • Service name: ad
  • Request URL:
GET http://foo.com/api/v2/ad/group

Example - Get list of all Active Directory Groups with specific fields

  • Service name: ad
  • Fields to retrieve: dn,cn,member
  • Request URL:
GET http://foo.com/api/v2/ad/group?fields=dn,cn,member

Example - Get specific Group information

  • Service name: ad
  • Group to retrieve: DreamFactory
  • Request URL:
GET http://foo.com/api/v2/ad/group/DreamFactory

Example - Get list of Groups by Active Directory Username

  • Service name: ad
  • Active Directory Username: jdoe
  • Request URL:
GET http://foo.com/api/v2/ad/group?user=jdoe

Example - Getting list of Groups by LDAP query filter.

  • Service name: ad
  • LDAP Query: (cn=Dream*) [List all groups where the cn starts with Dream]
  • Request URL:
GET http://foo.com/api/v2/ad/group?filter=(cn=Dream*)