# Logging into PetroAI

This guide walks you through the two methods for accessing the PetroAI platform: Microsoft Single Sign-On (SSO) and manual account creation.

# Method 1: Microsoft Single Sign-On (Recommended)

Microsoft SSO is the preferred login method as it leverages your existing work credentials and provides enhanced security through your organization's authentication system.

# Prerequisites for Microsoft SSO

Before you can use Microsoft SSO, your organization will need to configure the integration. Here's what you'll need to request from your IT department:

# What to Request from Your IT Team

Send the following request to your IT administrator:

Subject: Enable Microsoft SSO Integration for PetroAI Platform

Hi [IT Admin Name],

We need to enable Microsoft Single Sign-On (SSO) integration for the PetroAI platform. This will allow our team to log in using our existing work credentials.

Required Actions:

Add PetroAI as an approved enterprise application in our Azure AD/Microsoft 365 admin center

Configure user access permissions for our domain: [your-company-domain.com]

Enable the necessary API permissions for user authentication

Benefits:

Enhanced security through centralized authentication

No need for users to manage separate passwords

Automatic user provisioning and de-provisioning

Please let me know if you need any additional information from PetroAI support to complete this setup.

# IT Administrator Setup Notes

For IT Administrators

If you're an IT administrator setting up this integration, here's what the process involves:

Azure AD Configuration:

Navigate to Azure Active Directory > Enterprise Applications
Click "New Application" and search for "PetroAI" or add a custom SAML application
Configure the following settings:
- Sign-on URL: https://cloud.petro.ai/auth/sso
- Identifier (Entity ID): https://cloud.petro.ai
- Reply URL: https://cloud.petro.ai/auth/sso/callback

User Assignment:

Assign the application to users or groups who need access
Configure automatic user provisioning if desired
Set appropriate access policies and conditional access rules

Testing:

Test the SSO configuration with a pilot user before rolling out
Verify that user attributes (email, name, department) are mapped correctly

For technical assistance, contact PetroAI support at support@petro.ai with your tenant ID and any specific questions.

# Using Microsoft SSO

Once your IT team has enabled the integration:

Navigate to the PetroAI login page Go to https://cloud.petro.ai
Click "Sign in with Microsoft" You'll see a blue Microsoft button at the top of the login form
Authenticate with your work credentials You'll be redirected to your organization's Microsoft login page. Enter your work email and password as you normally would for other company applications.
Grant permissions (first time only) On your first login, you may be prompted to grant PetroAI permission to access your basic profile information. Click "Accept" to proceed.
Access granted You'll be automatically redirected back to PetroAI and logged into your account.

# Method 2: Manual Account Creation

If Microsoft SSO is not available for your organization, you can create a manual account using the registration form.

# Prerequisites for Manual Account Creation

Organization Setup Required

Before anyone can create an account, a PetroAI support engineer must first create your organization in the system. Contact support@petro.ai with your company details to initialize your organization.

# Account Creation Process

Navigate to the account creation page Go to https://cloud.petro.ai and click "Create Account" from the login page
Fill out the registration form Complete all required fields:
- First Name: Your given name
- Last Name: Your family name
- Work Email: Must use your company domain email address
- Password: Choose a secure password (minimum 8 characters, including uppercase, lowercase, numbers, and special characters)
- Password (again): Confirm your password by entering it again
Submit the form Click the "Create Account" button to submit your registration
Email verification Check your work email for a verification message and click the confirmation link
Access granted Once verified, you can log in using your email and password

# Important Notes for Manual Accounts

Domain restrictions: Only users with email addresses matching your organization's approved domain(s) can create accounts
User limits: Account creation may be limited based on your organization's subscription plan (some plans offer unlimited users)
Security: Manual accounts require regular password updates and do not benefit from your organization's security policies

# Troubleshooting

# Common SSO Issues

"Application not found" error

Contact your IT administrator to verify the PetroAI application has been properly configured in your organization's directory

"Access denied" error

Ensure your IT administrator has assigned the PetroAI application to your user account or group

Redirect loop or authentication failure

Clear your browser cache and cookies, then try again
If the issue persists, contact PetroAI support

# Common Manual Account Issues

"Domain not authorized" error

Your organization may not be set up in the system yet. Contact PetroAI support
Verify you're using your correct work email address

"User limit exceeded" error

Your organization has reached its subscription user limit. Contact your account administrator or PetroAI support to discuss options

Email verification not received

Check your spam/junk folder
Ensure emails from @petro.ai are not blocked by your email system
Contact PetroAI support if you still don't receive the verification email

# Getting Help

If you encounter any issues during the login process:

Technical Support: support@petro.ai
Account Questions: Contact your organization's PetroAI administrator
IT Integration Help: PetroAI support can provide technical documentation and assistance to your IT team

For fastest resolution, include your company name, email address, and a detailed description of the issue when contacting support.

← PetroAI Platform Build Overview →