CloudBerry Lab Resources
Get started with cloud backup and management solutions
default featured image

Getting started with Active Directory Bridge: How to provide cloud storage for AD users

Published: by on Post Type: Categories: AWS, CloudBerry Drive
CloudBerry Active Directory Bridge or just AD Bridge provides Windows-authenticated network users with an access to data stored in Amazon S3 with no need to specify credentials to the cloud storage. This powerful Active Directory software can make Windows users to work with S3 resources just like as if they worked with any Windows data. It works in conjunction with CloudBerry Drive.
CloudBerry AD Bridge can authenticate Windows users against Amazon Web Services resources. It supports AWS Identity and Access Management and provides an ability to link Windows users to Amazon IAM users’ accounts. AD domain administrators with the help of CloudBerry AD Bridge can use Amazon’s IAM features to set rights and restrictions for network users to access, upload and modify S3 data. Also you may find it nice that AD Bridge is integrated with CloudBerry Backup, CloudBerry Explorer and CloudBerry Drive extremely well.
In order to use such functionality you will need to install CloudBerry AD Bridge to a server and have CloudBerry Drive installed on each user computer you want to have access to S3 resources from. To install these applications you will need to use a command-line interface (CLI) on all computers.

How to install CloudBerry Active Directory Bridge on a Server

CloudBerry AD Bridge is a server-side service - it has to be installed on a server. To install CloudBerry AD Bridge:
1. Run the installation file.
2. Read the License Agreement and click on the “I Agree” button to proceed.
3. Specify a Destination Folder.
4. Wait for the end of the installation.
5. Once the installation is complete, click “Finish”. You can uncheck the “Run AD Bridge Service Settings” if you don’t want to run the service settings immediately.

How to request Trial for Active Directory Bridge software

During the installation you will have to set a port that will be used for interaction between the server and client computers. Also you will have to specify Amazon S3 account credentials and set up a bucket. Trial lasts 15 days.
1. Specify your actual email.
2. Click on the “Start Trial” button.
CloudBerry AD Bridge Activation
3. Specify your Amazon S3 account credentials (Access Key, Secret Key) and set up a bucket.
CloudBerry AD Bridge Activation
4. Specify a name for Shared folder and set a port that will be used for interaction between the server and client computers. Click “OK”.
5. Restart the service by clicking “Yes” button.
CloudBerry AD Bridge Activation
6. Set up proxy settings if necessary.
CloudBerry AD Bridge Activation
7. Set up diagnostic and logging settings if necessary.
CloudBerry AD Bridge Activation

How to activate a License for Active Directory Bridge software

1. Specify your actual email.
2. Enter your license key and click “Activate”.
CloudBerry AD Bridge Activation
3. Specify your Amazon S3 account credentials (Access Key, Secret Key) and set up a bucket.
CloudBerry AD Bridge Activation
4. Specify a name for Shared folder and set a port that will be used for interaction between the server and client computers. Click “OK”.
5. Restart the service by clicking “Yes” button.
CloudBerry AD Bridge Activation
6. Set up proxy settings if necessary.
CloudBerry AD Bridge Activation
7. Set up diagnostic and logging settings if necessary.
CloudBerry AD Bridge Activation

How to install CloudBerry Drive to a Client Computer

CloudBerry Drive with AD mode can be installed only via command line interface.
IMPORTANT: CloudBerry Drive installation requires local administrator privileges.
1. Open the command line interface (CLI): Start | Run: cmd
2. Run installation:
CloudBerryDriveSetup_vx.x.x.x.exe /mode=ad /endpoint="endpoint"
where /mode=ad enables CloudBerry Drive to interact with CloudBerry AD Bridge service, “endpoint” should look like
"http://server_computer_name_or_ip:port_specified_during_the_server_installation/ADGateway/Service/"
Note: if /registerscp was used for CloudBerry AD Bridge installation, you don’t need to specify the endpoint.
The installation is completed. CloudBerry Drive application runs automatically, you can find it in the tray.
Once the installation is complete, you can map drive by going to Options | Mapped Drives:adbridge-5
Click [...] to browse one of the folder: shared or personal.
Note: every domain user can read/write in SHARED folder and personally use its own PERSONAL folder.

Note: To troubleshoot any errors with silent mode installation look at install.log that is located in one of the following locations:

  • C:\Users\USERNAME\AppData\Local\Temp
  • C:\Documents and Settings\USERNAME\Local Settings\Temp
  • C:\Program Files\CloudBerryLab\CloudBerry Drive
Note: Silent installation (i.e. /S is used) is optional. You can run silent installation for CloudBerry Drive using the following command:
CloudBerryDriveSetup_vx.x.x.x.exe /S /mode=ad /endpoint="endpoint"
or without /endpoint="endpoint" if CloudBerry AD Bridge has been installed with /registerscp parameter.
Note: if you run silent installation for CloudBerry Drive, you will need to run CloudBerry Drive from All Programs menu to start the tray application.

Advanced: How to send logs to CloudBerryLab

To troubleshoot any issue you can send diagnostic information to CloudBerryLab team by using CLI commands:

Note: You need to start command line interface with "Run as administrator" option.

CloudBerryLab.ADGateway.WinService sendlog [-u "userName"] -e userEmail -m "message" where:

-u - specify your name (optional)
-e - specify your email
-m - specify issue details or feedback.

Advanced: How to change security, access key and a bucket for Active Directory Bridge when the product is already installed

You can change bucket, security and access keys after the installation. To change current settings you have to run CLI again and enter one of the following commands.
Note: service has to be stopped manually before you proceed with any changes. When you are finished you will also have to start service manually.
To change all the configuration settings by a single command:
CloudBerryLab.ADGateway.WinService.exe config -ac access key -sk secret key -bn bucket name -port port number
To change access key and secret key:
CloudBerryLab.ADGateway.WinService.exe config -ac access key -sk secret key
To change only bucket:
CloudBerryLab.ADGateway.WinService.exe config -bn bucket name
To set proxy settings (if needed):
CloudBerryLab.ADGateway.WinService.exe proxysettings -proxy [no|auto|manual] -pa proxy_address -pp proxy_port -pt proxyauthentication [yes|no] -pd domain -pu user -ps password
Note: if CloudBerry AD Bridge has been installed with /registerscp parameter, you have to restart CloudBerry Drive applications manually to apply these changes:
- click CloudBerry Drive tray icon, select Stop Drive
- then right-click on tray icon itself, exit the application
- start CloudBerry Drive application by going to Start | All Programs | CloudBerryLab | CloudBerry Drive
- click CloudBerry Drive tray icon, select Start Drive.
+++
You can download CloudBerry AD Bridge 15 day trial and try all of its features for free.
CloudBerry AD Bridge license for 10 connections comes at no charge.
Price of license for 100 connections is $499,99 and for 250 connections - $999.99.
1 Star2 Stars3 Stars4 Stars5 Stars (No Ratings Yet)
Loading...