gsuitemdm Cloud Function directory
A cloud Function component of the gsuitemdm package providing an API used to search for phone number data (name, phone number) among all tracked/configured mobile devices using name or email address as a search key.
This API might be useful for orgs who want a handy way to search for phone numbers among their company mobile device-using staff. With directory
you have an always up-to-date, automatically-updated mobile phone directory API that searches all device data in all configured G Suite domains.
The directory
API is used by the mdmtool
command line utility.
directory
uses a .yaml
file containing several environment variables the cloud function reads during app startup. These environment variables point the app to the shared master cloud function configuration and API key that are stored as Secret Manager secrets. An example .yaml
file for directory
:
APPNAME: directory
SM_APIKEY_ID: projects/12334567890/secrets/gsuitemdm_apikey
SM_CONFIG_ID: projects/12334567890/secrets/gsuitemdm_conf
HOW-TO Deploy directory
$ gcloud functions deploy Directory \
--runtime go111 \
--trigger-http \
--env-vars-file env_directory.yaml
HOW-TO Use directory
API
Example expected JSON to search for phone numbers including the name "doe":
{
"key": "0123456789",
"q": "doe",
"qtype": "name"
}
Example expected JSON to search for phone numbers associated with the email address "[email protected]":
{
"key": "0123456789",
"q": "[email protected]",
"qtype": "email"
}
Example command line using curl
and the above JSON that searches for phone numbers including the name "doe":
$ curl -X POST -d '{"key": "0123456789", "qtype": "name", "q": "doe"}' \
https://us-central1-<YOURGCPPROJECTNAME>.cloudfunctions.net/Directory
[
{
"name": "John Doe",
"email": "[email protected]",
"phonenumbner": "(213) 555-1212"
},
{
"name": "Jane Doe",
"email": "[email protected]",
"phonenumbner": "(213) 555-1313"
}
]
Example command line using curl
and the above JSON that searches for phone numbers associated with the email address "[email protected]":
$ curl -X POST -d '{"key": "0123456789", "qtype": "email", "q": "[email protected]"}' \
https://us-central1-<YOURGCPPROJECTNAME>.cloudfunctions.net/Directory
[
{
"name": "John Doe",
"email": "[email protected]",
"phonenumbner": "(213) 555-1212"
}
]
Example command line using mdmtool
to search for phone numbers including the name "doe":
$ mdmtool dir -n doe
----------------------+----------------+------------------------------------------
Name | Phone Number | Email
----------------------+----------------+------------------------------------------
Jane Doe | (213) 555-1313 | [email protected]
John Doe | (213) 555-1212 | [email protected]
----------------------+----------------+------------------------------------------
Search returned 2 results.
Example command line using mdmtool
to search for phone numbers associated with the email address "[email protected]":
$ mdmtool dir -e [email protected]
----------------------+----------------+------------------------------------------
Name | Phone Number | Email
----------------------+----------------+------------------------------------------
John Doe | (213) 555-1212 | [email protected]
----------------------+----------------+------------------------------------------
Search returned 1 results.