Citrix Access Gateway Standard Edition Activity Library

Description

This Activity Library was created to support a couple of workflows:

1. Add/Remove User
When adding a new employee, or removing an old employee, you have to manually add/delete that employee from quite a few systems. The activities provided in this library will allow an administrator to add/remove a user to/from the system, or even a specific group. If you utilize these activities in a workflow that also adds/removes a user from other Citrix products, you can streamline an otherwise tedious process.

2. Change Group Policy permissions on a schedule
If your Company has contractors that are only required to have access to your network during certain hours, you can create a workflow using the Allow/Deny Policy activities. Schedule the job to run the allow workflow at the start of the group of contractor's shift and the deny workflow at the end of their shift. This will automate a tedious duty of the very busy System Administrator.

Note: This Activity Library is not officially supported by Citrix. Our team created it as a tester to see what you, the user, likes/dislikes about it. Please let me know if you have any ideas for more WFs, we are always looking for as much feedback as possible.

Tips when creating workflows:

• ConnectToAG should always be the first activity in your WF.
• DisconnectFromAG should be the last.
• If you have a specific FQDN for your Access Gateway, specify it in the Connect To AG activity, in designer mode. If not, you don't need to do anything.
• If you ever receive the error: "Cannot access a disposed object Object name 'SslStream'." This is caused by
  the server not agreeing with what is being sent, whether it be the wrong username, or password, or trying to add a user that already exists, etc.
• These Activities only work with AGSE version 4.6

Download

Activities Include:

• Add/Remove User (local user)
• Add/Remove User to/from Group
• Connect/Disconnect
• Allow/Deny Application Policy
• Allow/Deny Network Policy
• Get Groups
• Get Group Policies
• Get Groups for a User
• Get MAC Address
• Get Users

Add User:
Input: Username and password.
If there is an error in the addition of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."

Remove User:
Input: Username
If there is an error in the removal of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."

Add user to group:
Input: Username, Group name
If there is an error in the addition of the user to the group, you will see the error: "Cannot access a disposed object Object name 'SslStream'."
If either user or group do not exist, the activity will fail.

Remove user from group:
Input: Username, Group name
If there is an error in the removal of the user from the group, you will see the error: "Cannot access a disposed object Object name 'SslStream'."
If either user or group do not exist, the activity will fail.

Allow/Deny Application Policy
Input: Policy name, Group name
If there is an error in the allowance/denial of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."
If either policy or group do not exist, the activity will fail.

Allow/Deny Network Policy
Input: Policy name, Group name
If there is an error in the allowance/denial of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."
If either policy or group do not exist, the activity will fail.

Connect to AG
Input: IP, username, password, fqdn(optional)
If there is an error in connecting to the AG, you will see the error: "Cannot access a disposed object Object name 'SslStream'."

Disconnect From AG:
Input: none
If there is an error in the allowance/denial of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."

Get Groups:
Input: none
Output: String Groups, List<String> Groups
If there is an error in the allowance/denial of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."

Get Users:
Input: none
Output: String Users, List<String> Users
If there is an error in the allowance/denial of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."

Get Group Policies:
Input: Type of policy: Application/Network/Both, Group name
Output: String Policies, List<Policy> Policies
note: a Policy has a String name, and a String status. Status is either deny or allow

Get Groups for User:
Input: username
Output: Sting Groups, List<String> Groups
If there is an error in the allowance/denial of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."

Get MAC Address:
Input: none
Output: String MAC
If there is an error in the allowance/denial of the user, you will see the error: "Cannot access a disposed object Object name 'SslStream'."

Disclaimer

These software applications are provided to you as is with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.