Break down Sources into individual sections in Docs (#1052)
* Create index.mdx Add Wekan example * updated to include wekan entry * Update and rename website/docs/sources.md to website/docs/sources/index.md Break Sources into individual pages. * Update and rename website/docs/sources/index.md to website/docs/sources/ldap/index.md * Create index.md * Update index.md * Update index.md * Create index.md * Create index.md * Create index.md * Update index.md * Update index.md * Update index.md * Create index.md * discord images * spacing * Added discord * discord changes * Added sources breakdown to the sidebar * Fixed the saml title * Added github examples * fixed formatting * Changed file path, updated sidebar, added google. * fixed a spelling mistake * Cleaned up formatting * Fixed Notes
							
								
								
									
										
											BIN
										
									
								
								website/docs/integrations/sources/google/authentiksource.png
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 34 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								website/docs/integrations/sources/google/googledeveloper1.png
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 103 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								website/docs/integrations/sources/google/googledeveloper2.png
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 22 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								website/docs/integrations/sources/google/googledeveloper3.png
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 26 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								website/docs/integrations/sources/google/googledeveloper4.png
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 51 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								website/docs/integrations/sources/google/googledeveloper5.png
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 34 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								website/docs/integrations/sources/google/googledeveloper6.png
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 56 KiB  | 
							
								
								
									
										83
									
								
								website/docs/integrations/sources/google/index.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						@ -0,0 +1,83 @@
 | 
			
		||||
---
 | 
			
		||||
title: Google
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Allows users to authenticate using their Google credentials
 | 
			
		||||
 | 
			
		||||
## Preparation
 | 
			
		||||
 | 
			
		||||
The following placeholders will be used:
 | 
			
		||||
 | 
			
		||||
- `authentik.company` is the FQDN of the authentik install.
 | 
			
		||||
 | 
			
		||||
## Google
 | 
			
		||||
 | 
			
		||||
You will need to create a new project, and OAuth credentials in the Google Developer console.  The developer console can be overwhelming at first.
 | 
			
		||||
 | 
			
		||||
1. Visit https://console.developers.google.com/ to create a new project
 | 
			
		||||
2. Create a New project. 
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
3. **Project Name**: Choose a name
 | 
			
		||||
4. **Organization**: Leave as defaut if unsure
 | 
			
		||||
5. **Location**: Leave as default if unsure
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
6. Click **Create**
 | 
			
		||||
7. Choose your project from the drop down at the top
 | 
			
		||||
8. Click the **Credentials** menu item on the left.  It looks like a key.
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
9. Click on **Configure Consent Screen**
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
10. **User Type:** If you do not have a Google Workspace (GSuite) account choose _External_.  If you do have a Google Workspace (Gsuite) account and want to limit acces to only users inside of your organization choose _Internal_
 | 
			
		||||
 | 
			
		||||
_I'm only going to list the mandatory/important fields to complete._
 | 
			
		||||
 | 
			
		||||
11. **App Name:** Choose an Application
 | 
			
		||||
12. **User Support Email:** Must have a value
 | 
			
		||||
13. **Authorized Domains:** authentik.company
 | 
			
		||||
14. **Developer Contact Info:** Must have a value
 | 
			
		||||
15. Click **Save and Continue**
 | 
			
		||||
16. If you have special scopes configured for google, enter them on this screen.  If not click **Save and Continue**
 | 
			
		||||
17. If you want to create Test Users enter them here, if not click **Save and Continue**
 | 
			
		||||
18. From the _Summary Page_ click on the **Credentials* link on the left.  Same link as step 8
 | 
			
		||||
19. Click **Create Credentials** on the top of the screen
 | 
			
		||||
20. Choose **OAuth Client ID**
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
21. **Application Type:** Web Application
 | 
			
		||||
22. **Name:** Choose a name
 | 
			
		||||
23. **Authorized redirect URIs:** `https://authenik.company/source/oauth/callback/google/`
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
24. Click **Create**
 | 
			
		||||
25. Copy and store _Your Client ID_ and _Your Client Secret_ for later
 | 
			
		||||
 | 
			
		||||
## Authentik
 | 
			
		||||
 | 
			
		||||
26. Under _Resources -> Sources_ Click **Create Google OAuth Source**
 | 
			
		||||
 | 
			
		||||
27. **Name**: Choose a name (For the example I use Google)
 | 
			
		||||
28. **Slug**: google (If you choose a different slug the URLs will need to be updated to reflect the change)
 | 
			
		||||
29. **Consumer Key:** Your Client ID from step 25
 | 
			
		||||
30. **Consumer Secret:** Your Client Secret from step 25
 | 
			
		||||
31. **Provider Type:** Google
 | 
			
		||||
 | 
			
		||||
Here is an exmple of a complete Authentik Google OAuth Source
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
Save, and you now have Google as a source.
 | 
			
		||||
 | 
			
		||||
:::note
 | 
			
		||||
For more details on how-to have the new source display on the Login Page see the Sources page
 | 
			
		||||
:::
 | 
			
		||||