Overview
- Google Customer ID
- Go to admin.google.com
- Go to Account > Account settings
- You should see your Customer ID in the Profile pane.
- Company Name
- e.g., Crossware Limited
- Primary Domain
- e.g., mail-signature.com
- Admin Email
- e.g., admin@mail-signature.com
You will need Super Admin access to complete these tasks.
There are 4 main steps:
1. Grant Crossware Mail Signature permissions
2. Create two groups in the Directory
3. Create one Google Workspace Gmail Hosts
4. Create one Google Workspace Gmail Routing Rule
Step 1 - Permissions
Firstly, we need to give Crossware Mail Signature permissions to access your Directory Data.
Client ID: 114734196798062831722
Scopes:
https://www.googleapis.com/auth/admin.directory.group.readonly
https://www.googleapis.com/auth/admin.directory.domain.readonly
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/admin.directory.customer.readonly
Now navigate back to the API Controls screen
Fill in the form with the following information:
- Client ID: 928646364906-vjarqcqr254p29bs28n24e5fjabivvev.apps.googleusercontent.com
- App access: Limited
Step 2 - Create Groups
Log into your Google Workspace Admin Console using your Google login credentials.
You can access this at https://admin.google.com
You will be creating two groups:
- One of the label Mailing with the name CrosswareMailSignatureUsers
(Email for users in this group will be sent to Crossware Mail Signature for processing)
- One of the label Security with the name CrosswareMailSignatureAdmins
(Users in this group will be able to configure Crossware Mail Signature)
See the following screenshots
- Create CrosswareMailSignatureUsers group
- Create CrosswareMailSignatureAdmins group
Step 3 - Create Connectors
Log into your Google Workspace Admin Console using your Google login credentials.
You can access this at https://admin.google.com
Enter the smart-host name for your region as per the below list:
(Copy and paste one of these into the add smart host field)
Smart Host Details:
Australia: xware-aus-gk1-east-1.crossware.co.nz
Link to Crossware SPF records (if required): SPF Record Doc
- Next, go to Routing
- Go to SMTP relay service and click on CONFIGURE
For the next form, fill out the information as follows:
1. Select 'Only addresses in my domains'
2. Select the 'Only accept mail from the specified IP addresses' option
a. Click on the Add button
b. Description: CrosswareAUS-GK1Egress
c. IP Address: 20.92.172.105
d. Select the 'Enable' tickbox and click SAVE
3. Select the 'Require TLS encryption' option
Step 4 - Create Routing Rule
Go to the Compliance section of the Gmail Admin Console
Go to the Content compliance section and click on 'CONFIGURE'
Apply the following settings:
Short Description: CrosswareTransportRule
1. Select the 'Outbound' & 'Internal - sending' option
2. a. Select the 'If ANY of the following match the message' option from the drop-down
b. Click on Add
i. Select 'Advanced content match'
ii. Location: Full Headers
iii. Match type: Not contains text
iv. Content: (Please copy the following string and paste it into the Content value field)
x-cwesigprocessed: Y
3. a. Select the 'Modify the message' option
b. i. Go to the Route section and select the 'Change the route' option
ii. Select the CrosswareOutboundHost option from the drop-down
c. Go to the Encryption (onward delivery only) section and select the 'Require secure transport (TLS)' option
Now click on 'Show options' at the bottom of the form
Configure the following:
B. Account types to affect: Users & Groups
C: i. Select the 'Only affect specific envelope senders' option
ii. Select 'Group membership (sent mail only)' from the drop-down
iii. Click on 'Select groups'
iv. Select the CrosswareMailSignatureUsers group that was previously created on Step 2.
Congratulations! You have completed your setup.
You can now log back into the Crossware Mail Signature Portal to configure your email Signatures