To connect your developers securely through the PSM to their GitHub, We can use our TOTP MFA Code Generator to create a secure MFA connection to the GitHub website.
In this way, the developer must authenticate the GitHub user with our TOTP application in the PSM before using the website.
First, we will need to download the below integrations from our Marketplace. To download, please first login to the Marketplace and then visit the below links:
1.
TOTP MFA Code Generator(This integration is Certified by Idira and is fully supported)
2.
Amazon Web Services (AWS) Root Management with MFA(This integration is a Contributed Integration- not Reviewed or Supported)
The TOTP MFA Code Generator is our connection component for the MFA and GitHub platforms. It also contains the TOTPToken.exe application, which will be copied to the PSM server.
> From the "Amazon Web Services (AWS) Root Management with MFA", we will need to extract the "MFADeviceKeys-v12.5.zip", which is our platform of use.
1. Import the "MFADeviceKeys-v12.5.zip" as a platform in the PVWA; it will be saved within the 'Website' platforms.
Add the "TOTP MFA Code Generator" as a connector package to that platform and associate a PSM server with it.
2. Duplicate the 'GenericWebApp' platform to a new platform that can be called 'GitHub Account' and associate the TOTP connection component and a PSM server with that platform.
You must also define "LogonAccount" in its 'linked accounts' properties with 'PropertyIndex' set as 1.
3. Check on the PSM Serve {PSMInstallDir}\Components there’s a file named TOTPToken.exe
a. If the file TOTPToken.exe isn’t in {PSMInstallDir}\Components, extract it from PSM-TOTPToken.zip file and copy it to {PSMInstallDir}\Components
b. Add the following line in the PSMConfigureApplocker.xml file in <!--PSM Components> Section:
<Application Name="TOTPToken" Type="Exe" SessionType="*" Path="C:\Program
Files (x86)\CyberArk\PSM\Components\TOTPToken.exe" Method="Hash" />
Note: The TOTPToken.exe file path can be changed according to {PSMInstallDir}\Components folder
c. Execute the PSMConfigureApplocker.ps1 script to add new rules to Application Locker settings
4. In GitHub account settings, enable the two-factor authentication and copy the security key:
* Locate "Unable to scan? You can use the setup key to manually configure your authenticator app." click on the setup key and copy your "Your two-factor secret key"
5. Add Account in the PVWA with your GitHub account details and the security key as its password - the account platform needs to be the 'MFADeviceKeys' platform.
6. Add Account in the PVWA with your GitHub account details and its regular password - this account platform needs to be the 'GitHub Account'.
* The address for the account should be - https://github.com/login
* Unselect the "Allow automatic password management"
7. Add the 'MFA Device Keys' account to the 'GitHub Account' as a' Logon account'.
8. Try to logon to the TOTP Token; it should open the TOTPToken application and generate a one-time passcode that you will need to copy to your GitHub MFA page to complete the authentication and download the github-recovery-codes.txt.