Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[Feature Request] Add Python module for Creating a New Google Workspace Account

Open
  • Is something wrong?
#5 0 comments 0 reactions 2 assignees View on GitHub

@brokensound77 is already working on this.

Since May 9, 2023.

Assessment

This issue has not been assessed yet.

Description

API: Admin enhancement Tactic: Persistence Technique: T1136

🐍 Python Module for MITRE ATT&CK Technique

Tactic Name: Persistence

Technique Name: Create Account

Technique ID: T1136

Technique Description: Adversaries may create an account to maintain access to victim systems. With a sufficient level of access, creating such accounts may be used to establish secondary credentialed access that do not require persistent remote access tools to be deployed on the system.

Describe the solution you'd like

New Google Workspace Account Creation Module for use with a compromised GWS environment for Persistence.

Requirements: 
- Google Admin SDK API enabled
- Python packages (google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client, email, base64)
- Scopes (https://www.googleapis.com/auth/admin.directory.user, https://www.googleapis.com/auth/admin.directory.rolemanagement)

Module Workflow:
Step 1: Enter the account first name:
Step 2: Enter the account last name:
Step 3: Enter the email for the account:
Step 4: Enter the password (temporary):
Step 5: Create

Module Actions:
 1. Authenticate
 2. Create a new user
 3. Create a custom role with the desired permissions
 4. Assign the role to the newly created user
 5. Enable or disable API access for the user
 6. Return Success with user email and password

ChatGPT Example Script

from google.oauth2 import service_account
from googleapiclient import discovery, errors

# Replace with your credentials file path and your Google Workspace domain
SERVICE_ACCOUNT_FILE = 'path/to/credentials.json'
DOMAIN = 'your-domain.com'

# Set up credentials with the required scopes
credentials = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE,
    scopes=['https://www.googleapis.com/auth/admin.directory.user',
            'https://www.googleapis.com/auth/admin.directory.rolemanagement'])

# Create an Admin SDK API client
service = discovery.build('admin', 'directory_v1', credentials=credentials)

# Create a user
user_body = {
    'primaryEmail': 'new-user@{}'.format(DOMAIN),
    'name': {
        'givenName': 'John',
        'familyName': 'Doe'
    },
    'password': 'UserPassword123'
}
user = service.users().insert(body=user_body).execute()

# Create a custom role with specific permissions
role_body = {
    'roleName': 'Custom Role',
    'rolePrivileges': [
        {
            'privilegeName': 'User Management',
            'serviceId': 'your-service-id'
        }
    ]
}
role = service.roles().insert(customer='my_customer', body=role_body).execute()

# Assign the custom role to the user
assignment_body = {
    'roleId': role['roleId'],
    'assignedTo': user['id']
}
assignment = service.roleAssignments().insert(customer='my_customer', body=assignment_body).execute()

print('User created and custom role assigned')
Dominant language
Python
Stars
169
Forks
8
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from elastic/SWAT

All issues in elastic/SWAT

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.