Skip to content

Commit f77cee8

Browse files
summittsummitt
committed
updating ODIC to include ping identity
1 parent 48837ae commit f77cee8

46 files changed

Lines changed: 3210 additions & 442 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/Custom Security Report Templates.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ The Faction Report Designer allows you to create custom security report template
99
You can download the sample templates here:
1010
[Sample Templates](https://github.com/factionsecurity/report_templates)
1111

12-
!! note
12+
!!! note
1313
You should disable spellcheck in your template document while adding variables. The spellcheck can cause the variables to contain attributes that will make the variable unrecognizable to the Faction document parser.
1414

1515

docs/Integrate Faction into OAuth Solutions.md renamed to docs/Integrate Faction into ODIC Solutions.md

Lines changed: 35 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
22
tags: [ Authentication, Core Features]
33
date: 2023-12-18
44
---
5-
# Integrate Faction into OAuth Solutions
6-
Faction seamlessly integrates with your existing enterprise authentication solutions, ensuring a smooth and secure user experience. Leveraging widely adopted solutions such as LDAP and OAuth, Faction effortlessly integrates into any enterprise environment. Our platform is designed to adapt to your authentication infrastructure, providing a hassle-free implementation process and enhancing the overall efficiency of your organization’s security framework. With Faction, you can trust in a unified and streamlined authentication experience tailored to your enterprise needs.
5+
# Integrate Faction into ODIC Solutions
6+
Faction seamlessly integrates with your existing enterprise authentication solutions, ensuring a smooth and secure user experience. Leveraging widely adopted solutions such as LDAP and ODIC, Faction effortlessly integrates into any enterprise environment. Our platform is designed to adapt to your authentication infrastructure, providing a hassle-free implementation process and enhancing the overall efficiency of your organization’s security framework. With Faction, you can trust in a unified and streamlined authentication experience tailored to your enterprise needs.
77

8-
The article will walk through the steps needed to integrate [Faction](https://www.factionsecurity.com/) into [Google Auth](https://console.developers.google.com/) or [Auth0](https://auth0.com/).
8+
The article will walk through the steps needed to integrate [Faction](https://www.factionsecurity.com/) into [Google Auth](https://console.developers.google.com/), [Auth0](https://auth0.com/), or [Ping Identity](https://www.pingidentity.com/en.html)
99

10-
## Google OAuth Setup
10+
## Google OCIC Setup
1111
1. Log into your company’s [Google API Console](https://console.developers.google.com/).
1212
2. Click on **Credentials** from the left navigation.
1313
3. Click **+ Create Credentials** from the top navigation.
1414
4. Select **OAuth Client ID.**
1515
5. Select **Web Application** as the application type.
16-
6. Name the application something specific like **Faction OAuth Integration.** But the name does not matter.
16+
6. Name the application something specific like **Faction ODIC Integration.** But the name does not matter.
1717
7. Under **Authorized redirect URLs** click **+ ADD URI**.
1818
8. Enter the domain of your Faction Instance and append **/oauth/callback?client_name=OidcClient** to the path. Example: If you used Faction to host the site your URL would look like this:
1919
https://furry-hyena-1111.factionsecurity.com/oauth/callback?client_name=OidcClient
@@ -39,17 +39,43 @@ Your Setup should look like the following:
3939
11. Take note of the **OpenId Configuration** URL
4040
![](files/Pasted%20image%2020231218082551.png)
4141

42-
42+
## Ping Identity Setup
43+
1. Log into [Ping Identity Console](https://admin.pingone.com/web-portal/login)
44+
2. Select Applications.
45+
3. Add a New Application.
46+
4. Give the Application a name like Faction.
47+
5. Select OIDC Web App.
48+
6. Click Save.
49+
![](/files/Pasted%20image%2020241030210354.png)
50+
7. Open the newly created application and select the Configuration tab:
51+
![](/files/Pasted%20image%2020241030210859.png)
52+
8. Click the Edit Button in the upper right corner
53+
9. Scroll down to the Redirect URI Section and enter your Host Name with the path `/oauth/*`. (Example: `https://furry-hyena-1111.factionsecurity.com/oauth/*`)
54+
10. Click Enable Redirect Patterns.
55+
![](/files/Pasted%20image%2020241030211237.png)
56+
11. Click Save.
57+
12. Scroll up to the top of the configuration.
58+
13. Expend __URLs__ and take note of the the __OIDC Discovery Endpoint__. This will be used later in the __Configure Faction Section__.
59+
14. Take Note of the __Client Id__ and the __Client Secret__. These will be used in the __Configure Faction Section__
60+
15. Click the __Attribute Mappings__ tab.
61+
16. Add email as an attribute.
62+
![](/files/Pasted%20image%2020241030211944.png)
63+
17. Click Save.
64+
4365
## Configure Faction
4466
1. Log into **Faction** as an admin user.
4567
2. Navigate to **Admin** -> **Users**.
46-
3. In the **OAuth2.0 Configuration** enter the Client Id you noted earlier from either Auth0 or Google.
68+
3. In the **OAuth2.0 Configuration** enter the __Client Id__ you noted earlier from either Auth0, Google, or Ping.
4769
4. Enter the **Client Secret** you noted earlier.
48-
5. Enter the **Discovery URL** as follows:**Google:** _https://accounts.google.com/.well-known/openid-configuration_
49-
**Auth0:** Enter the **Open Id Configuration** URL you noted in step 11 above.
70+
5. Enter the **Discovery URL** as follows:
71+
1. **Google:** _https://accounts.google.com/.well-known/openid-configuration_
72+
2. **Auth0:** Enter the **Open Id Configuration** URL you noted in step 11 above.
73+
3. **Ping**: Enter the __OIDC Discovery Endpoint__ from step 13 above.
5074
6. Click **Save**
5175
![](files/Pasted%20image%2020231218082632.png)
5276

77+
78+
5379
## Adding an OAuth User
5480
1. Under **Admin -> Users**, Click **Add User.**
5581
2. The Username should be part of the user’s email address before the @ symbol. If the email is **test.user@yourcompany.com** then the username is **test.user**

‎docs/Table of Contents Numbering.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ tags: [Reporting, Enterprise, Paid Feature, Managed]
33
date: 2024-10-20
44
---
55

6-
Faction's open-source versions will not automatically update the Table of Contents page numbering though the hyperlinks all work as expected. You can do this manually by clicking the table and selecting update numbering you to update it manually once you generate the report.
6+
Faction's open-source versions will not automatically update the Table of Contents page numbering though the hyperlinks all work as expected. You can do this manually by clicking the table and selecting _Update Field_ on the generated report.
77
![](/files/Pasted%20image%2020241020221013.png)
88

99
The enterprise versions of Faction will automatically update the numbering for you as well as provide other additional reporting features like different finding sections (i.e. Application Security Pen Test Findings Section and Network Security Findings Section) and DOCX and PDF export options.

‎docs/blog/posts/How To Generate a Vulnerability Report in Faction.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
tags: [ Reporting ]
3+
date: 2024-10-22
4+
---

‎docs/files/Pasted image 20241030210354.png‎

400 KB
Loading

‎docs/files/Pasted image 20241030210859.png‎

57.4 KB
Loading

‎docs/files/Pasted image 20241030211237.png‎

47.6 KB
Loading

‎docs/files/Pasted image 20241030211944.png‎

156 KB
Loading

‎site/404.html‎

Lines changed: 34 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -342,11 +342,11 @@
342342

343343

344344
<li class="md-nav__item">
345-
<a href="/Integrate%20Faction%20into%20OAuth%20Solutions/" class="md-nav__link">
345+
<a href="/Integrate%20Faction%20into%20ODIC%20Solutions/" class="md-nav__link">
346346

347347

348348
<span class="md-ellipsis">
349-
Integrate Faction into OAuth Solutions
349+
Integrate Faction into ODIC Solutions
350350
</span>
351351

352352

@@ -421,6 +421,26 @@
421421

422422

423423

424+
<li class="md-nav__item">
425+
<a href="/Table%20of%20Contents%20Numbering/" class="md-nav__link">
426+
427+
428+
<span class="md-ellipsis">
429+
Table of Contents Numbering
430+
</span>
431+
432+
433+
</a>
434+
</li>
435+
436+
437+
438+
439+
440+
441+
442+
443+
424444
<li class="md-nav__item">
425445
<a href="/Using%20Markdown%20in%20Reports/" class="md-nav__link">
426446

@@ -505,7 +525,7 @@
505525

506526

507527

508-
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_14" >
528+
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_15" >
509529

510530

511531

@@ -521,14 +541,14 @@
521541
</a>
522542

523543

524-
<label class="md-nav__link " for="__nav_14" id="__nav_14_label" tabindex="0">
544+
<label class="md-nav__link " for="__nav_15" id="__nav_15_label" tabindex="0">
525545
<span class="md-nav__icon md-icon"></span>
526546
</label>
527547

528548
</div>
529549

530-
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_14_label" aria-expanded="false">
531-
<label class="md-nav__title" for="__nav_14">
550+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_15_label" aria-expanded="false">
551+
<label class="md-nav__title" for="__nav_15">
532552
<span class="md-nav__icon md-icon"></span>
533553
APIS
534554
</label>
@@ -632,7 +652,7 @@
632652

633653

634654

635-
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_15" >
655+
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_16" >
636656

637657

638658

@@ -648,14 +668,14 @@
648668
</a>
649669

650670

651-
<label class="md-nav__link " for="__nav_15" id="__nav_15_label" tabindex="0">
671+
<label class="md-nav__link " for="__nav_16" id="__nav_16_label" tabindex="0">
652672
<span class="md-nav__icon md-icon"></span>
653673
</label>
654674

655675
</div>
656676

657-
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_15_label" aria-expanded="false">
658-
<label class="md-nav__title" for="__nav_15">
677+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_16_label" aria-expanded="false">
678+
<label class="md-nav__title" for="__nav_16">
659679
<span class="md-nav__icon md-icon"></span>
660680
Blog
661681
</label>
@@ -685,10 +705,10 @@
685705

686706

687707

688-
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_15_2" >
708+
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_16_2" >
689709

690710

691-
<label class="md-nav__link" for="__nav_15_2" id="__nav_15_2_label" tabindex="0">
711+
<label class="md-nav__link" for="__nav_16_2" id="__nav_16_2_label" tabindex="0">
692712

693713

694714
<span class="md-ellipsis">
@@ -699,8 +719,8 @@
699719
<span class="md-nav__icon md-icon"></span>
700720
</label>
701721

702-
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_15_2_label" aria-expanded="false">
703-
<label class="md-nav__title" for="__nav_15_2">
722+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_16_2_label" aria-expanded="false">
723+
<label class="md-nav__title" for="__nav_16_2">
704724
<span class="md-nav__icon md-icon"></span>
705725
Archive
706726
</label>

‎site/APIS/App Store Extension API/index.html‎

Lines changed: 34 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -353,11 +353,11 @@
353353

354354

355355
<li class="md-nav__item">
356-
<a href="../../Integrate%20Faction%20into%20OAuth%20Solutions/" class="md-nav__link">
356+
<a href="../../Integrate%20Faction%20into%20ODIC%20Solutions/" class="md-nav__link">
357357

358358

359359
<span class="md-ellipsis">
360-
Integrate Faction into OAuth Solutions
360+
Integrate Faction into ODIC Solutions
361361
</span>
362362

363363

@@ -432,6 +432,26 @@
432432

433433

434434

435+
<li class="md-nav__item">
436+
<a href="../../Table%20of%20Contents%20Numbering/" class="md-nav__link">
437+
438+
439+
<span class="md-ellipsis">
440+
Table of Contents Numbering
441+
</span>
442+
443+
444+
</a>
445+
</li>
446+
447+
448+
449+
450+
451+
452+
453+
454+
435455
<li class="md-nav__item">
436456
<a href="../../Using%20Markdown%20in%20Reports/" class="md-nav__link">
437457

@@ -516,7 +536,7 @@
516536

517537

518538

519-
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_14" checked>
539+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_15" checked>
520540

521541

522542

@@ -532,14 +552,14 @@
532552
</a>
533553

534554

535-
<label class="md-nav__link " for="__nav_14" id="__nav_14_label" tabindex="0">
555+
<label class="md-nav__link " for="__nav_15" id="__nav_15_label" tabindex="0">
536556
<span class="md-nav__icon md-icon"></span>
537557
</label>
538558

539559
</div>
540560

541-
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_14_label" aria-expanded="true">
542-
<label class="md-nav__title" for="__nav_14">
561+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_15_label" aria-expanded="true">
562+
<label class="md-nav__title" for="__nav_15">
543563
<span class="md-nav__icon md-icon"></span>
544564
APIS
545565
</label>
@@ -757,7 +777,7 @@
757777

758778

759779

760-
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_15" >
780+
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_16" >
761781

762782

763783

@@ -773,14 +793,14 @@
773793
</a>
774794

775795

776-
<label class="md-nav__link " for="__nav_15" id="__nav_15_label" tabindex="0">
796+
<label class="md-nav__link " for="__nav_16" id="__nav_16_label" tabindex="0">
777797
<span class="md-nav__icon md-icon"></span>
778798
</label>
779799

780800
</div>
781801

782-
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_15_label" aria-expanded="false">
783-
<label class="md-nav__title" for="__nav_15">
802+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_16_label" aria-expanded="false">
803+
<label class="md-nav__title" for="__nav_16">
784804
<span class="md-nav__icon md-icon"></span>
785805
Blog
786806
</label>
@@ -810,10 +830,10 @@
810830

811831

812832

813-
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_15_2" >
833+
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_16_2" >
814834

815835

816-
<label class="md-nav__link" for="__nav_15_2" id="__nav_15_2_label" tabindex="0">
836+
<label class="md-nav__link" for="__nav_16_2" id="__nav_16_2_label" tabindex="0">
817837

818838

819839
<span class="md-ellipsis">
@@ -824,8 +844,8 @@
824844
<span class="md-nav__icon md-icon"></span>
825845
</label>
826846

827-
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_15_2_label" aria-expanded="false">
828-
<label class="md-nav__title" for="__nav_15_2">
847+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_16_2_label" aria-expanded="false">
848+
<label class="md-nav__title" for="__nav_16_2">
829849
<span class="md-nav__icon md-icon"></span>
830850
Archive
831851
</label>

0 commit comments

Comments
 (0)