Skip to content

Commit 7c74ecb

Browse files
ajfarkasajfarkas
authored
Merge pull request #562 from GSA-TTS/aj/portal-130_partner-checklist
Portal #130 partner integration checklist
2 parents 5ae3611 + ba9e28c commit 7c74ecb

File tree

3 files changed

+86
-53
lines changed

3 files changed

+86
-53
lines changed

‎_pages/index.md‎

Lines changed: 56 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -3,53 +3,64 @@ title: Welcome to the Login.gov Developer Guide
33
lead: >
44
This developer guide contains everything you’ll need to integrate and deploy your application with Login.gov.
55
permalink: /
6-
layout: home
6+
7+
sidenav:
8+
- text: How to integrate with Login.gov
9+
href: '#how-to-integrate-login'
10+
- text: Integration information checklist
11+
href: '#integration-info-checklist'
712
---
813

9-
<div class="grid-container">
10-
<div class="desktop:grid-col-9 desktop:grid-offset-2 mobile:grid-col-auto mobile:padding-2">
11-
{% if site.temporary_alert %}
12-
<section class="usa-section" markdown="1">
13-
{% include alert.html content=site.temporary_alert %}
14-
</section>
15-
{% endif %}
16-
<h2 class='margin-top-4'>How to integrate with Login.gov</h2>
17-
<ol class="usa-process-list usa-prose margin-bottom-4">
18-
<li class="usa-process-list__item">
19-
<p>
20-
Your integration with Login.gov starts in the <a href="{{ site.baseurl }}/testing/#using-the-sandbox" class="usa-link">portal</a> where you can register your app.
21-
</p>
22-
</li>
23-
<li class="usa-process-list__item">
24-
<p>
25-
Determine your application needs, like the level of proofing and <a href="{% link _pages/attributes.md %}" class="usa-link">user attributes</a> that will be requested.
26-
</p>
27-
</li>
28-
<li class="usa-process-list__item">
29-
<p>
30-
Select between <a href="{% link _pages/oidc/getting-started.md %}" class="usa-link">Open ID Connect</a> (OIDC) or <a href="{% link _pages/saml/getting-started.md %}" class="usa-link">SAML</a> implementation protocols.
31-
</p>
32-
</li>
33-
<li class="usa-process-list__item">
34-
<p>
35-
Configure your app in the portal and start <a href="{% link _pages/testing.md %}" class="usa-link">testing</a>! We have implementation guides and example apps to get you up and running quickly.
36-
</p>
37-
</li>
38-
<li class="usa-process-list__item">
39-
<p>
40-
When you are ready to go live our team will help you <a href="{% link _pages/production.md %}" class="usa-link">promote the application to production</a>. We will check against our production checklist to ensure your application is ready for production from an administrative and technical standpoint.
41-
</p>
42-
</li>
43-
</ol>
44-
<hr class="text-primary-light border-solid measure-5 margin-x-0">
45-
<section class="usa-section usa-prose padding-top-5">
46-
<h2>Integration support for developers</h2>
47-
<p class="measure-5 margin-x-0" markdown="1">
48-
If you are with a government agency partner, check our [FAQ]({{ site.baseurl}}/support/#frequently-asked-questions) page for answers to the most common questions. If you need further technical assistance with an integration, you can [contact Partner Support]({{ site.baseurl}}/support/#contacting-partner-support).
14+
{% if site.temporary_alert %}
15+
<section class="usa-section" markdown="1">
16+
{% include alert.html content=site.temporary_alert %}
17+
</section>
18+
{% endif %}
19+
<section class="margin-bottom-4">
20+
<h2 id="how-to-integrate-login" class="padding-bottom-3 margin-top-0">How to integrate with Login.gov</h2>
21+
<ol class="usa-process-list margin-bottom-4">
22+
<li class="usa-process-list__item">
23+
<h3>Register your application in our partner portal</h3>
24+
<p>
25+
First, create a team. Then, follow the steps to create an application in a sandbox environment where you can configure and test without affecting your live systems.
26+
</p>
27+
</li>
28+
<li class="usa-process-list__item">
29+
<h3>Configure your application in the portal and start testing</h3>
30+
<p>
31+
Utilize our <a class="usa-link" href="#integration-info-checklist" aria-label="anchor">integration checklist</a> to verify you have all the necessary information for configuration. If you're not sure which options are right for your team, or if you're using a third-party application identity platform, please review our <a class="usa-link" href="{% link _pages/overview.md %}">integrations guide</a> for more information.
4932
</p>
50-
<p class="measure-5 margin-x-0">
51-
For help signing in or verifying your identity with Login.gov, please visit the <a href="https://login.gov/help/" class="usa-link">Login.gov Help Center</a> or <a href="https://login.gov/contact/" class="usa-link">contact us</a>.
33+
</li>
34+
<li class="usa-process-list__item">
35+
<h3>Create a new application that's ready for production and make a request for your application to go live</h3>
36+
<p>
37+
Create a <a class="usa-link" href="{% link _pages/production.md %}#production-configuration-process">new application and make a request</a> to go live in production. We'll check your application to ensure it meets all administrative and technical requirements. Applications can only go live if you've completed an <a class="usa-link" href="{% link _pages/production.md %}#confirm-interagency-agreement-iaa">Inter-Agency Agreement</a>.
5238
</p>
53-
</section>
39+
</li>
40+
</ol>
41+
</section>
42+
<hr class="text-primary-light border-solid measure-5 margin-x-0">
43+
<section class="margin-top-3 margin-bottom-4">
44+
<h2 id="integration-info-checklist">Integration information checklist</h2>
45+
<div id="home-register-checklist-accordion" class="usa-accordion usa-accordion__heading usa-accordion--bordered margin-bottom-3 maxw-tablet">
46+
<button class="usa-accordion__button" aria-expanded="true" aria-controls="home-register-checklist">
47+
Information you need to register your application
48+
</button>
49+
<div id="home-register-checklist" class="usa-accordion__content">
50+
<ul class="usa-list list-style-checkbox">
51+
<li>Inter-agency agreement application name</li>
52+
<li>Public-face, friendly application name</li>
53+
<li>Implementation protocols (SAML or Open ID Connect)</li>
54+
<li>Service level as either Authentication only or Identity Verification</li>
55+
<li>Data you need to keep and collect and other <a class="usa-link" href="{% link _pages/attributes.md %}">user attributes</a></li>
56+
<li><a class="usa-link" href="{% link _pages/oidc/authorization.md %}#aal_values">Authentication assurance</a> levels</li>
57+
<li>Agency logo file</li>
58+
<li>A public/private key pair and the <a class="usa-link" href="{% link _pages/testing.md %}#creating-a-public-certificate">public certificate</a> to validate your website and application’s authenticity</li>
59+
<li>Content for the “sign up”, “sign in”, and “forgot password” language if you do not want to use the pre-selected options. Custom “Help” text is optional.</li>
60+
</ul>
61+
</div>
5462
</div>
55-
</div>
63+
</section>
64+
<p class="measure-5 margin-x-0">
65+
This website is for agency partners or developers. If you need technical support please contact <a class="usa-link" href="{% link _pages/support.md %}#contacting-partner-support">Partner Support</a> or view our <a class="usa-link" href="{% link _pages/support.md %}#frequently-asked-questions">FAQ</a> page. If you are not an agency partner or developer, please visit the <a class="usa-link" href="https://login.gov/help/">Login.gov Help Center</a> or <a class="usa-link" href="https://login.gov/contact/">contact us</a> for help signing in to your account or verifying your identity.
66+
</p>

‎assets/scss/main.css.scss‎

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,14 @@ main.usa-layout-docs {
5151
}
5252

5353

54-
.usa-prose > ul > .doc-sub-nav-item {
55-
margin-bottom: 0px;
54+
.usa-prose {
55+
& > ul > .doc-sub-nav-item {
56+
margin-bottom: 0px;
57+
}
58+
59+
li.usa-process-list__item {
60+
@include u-padding-bottom(3);
61+
}
5662
}
5763

5864
.code-button {
@@ -174,6 +180,22 @@ button.code-button:hover {
174180
display: inline;
175181
}
176182

183+
.list-style-checkbox {
184+
& li {
185+
position: relative;
186+
list-style-type: none;
187+
padding-left: 0.5em;
188+
189+
&:before {
190+
content: '☐';
191+
position: absolute;
192+
left: -0.85em;
193+
top: -0.4ex;
194+
font-size: 1.2em;
195+
}
196+
}
197+
}
198+
177199
@media (min-width: 1024px) {
178200
.code-snippet-column {
179201
background-color: transparent;

‎package-lock.json‎

Lines changed: 6 additions & 6 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)