-
Notifications
You must be signed in to change notification settings - Fork 1
/
faq.html
127 lines (126 loc) · 8.93 KB
/
faq.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
<!doctype html>
<html>
</head>
<title>Web SDK v2 Repository Deprecation FAQ</title>
<link rel="stylesheet" href="./style.css">
</head>
<body>
<h1><center>Duo Security</center></h1>
<div class="faq-detail">
<div class="faq-nav">
<div class="sticky-wrapper">
<div class="faq-sticker">
<h4 class="faq-nav-header">Contents</h4>
<ul>
<li><a href="#Question1">When will the Web SDK v2 GitHub repositories be deprecated?</a></li>
<li><a href="#Question2">I'm using the Universal Prompt, does this affect me?</a></li>
<li><a href="#Question3">How do I know if I'm using Web SDK v2 or the Universal Prompt?</a></li>
<li><a href="#Question4">Will my Web SDK v2 integrations still work?</a></li>
<li><a href="#Question5">Can I keep using the Web SDK v2 GitHub repositories after they are deprecated?</a></li>
<li><a href="#Question6">Can I still create Duo Web SDK v2 integrations that use the deprecated Web SDK v2 GitHub repositories?</a></li>
<li><a href="#Question7">Why is Duo deprecating the Web SDK v2 GitHub repositories?</a></li>
<li><a href="#Question8">Which GitHub repositories are being deprecated?</a></li>
<li><a href="#Question9">How do I upgrade an application to the Universal Prompt?</a></li>
<li><a href="#Question10">What does deprecation of the Web SDK v2 GitHub repositories mean?</a></li>
<li><a href="#Question11">What will happen to the Web SDK v2 packages in package managers, for example PyPi?</a></li>
<li><a href="#Question12">What about Web SDK v2 GitHub repositories that don't have a Universal Prompt version? Like duo_ruby or duo_perl?</a></li>
</ul>
</div>
</div>
</div>
<div class="faq-content">
<h2>Web SDK v2 Repository Deprecation Frequently Asked Questions</h2>
<p>last updated June 24th, 2022</p>
<div id="Question1">
<h3>When will the Web SDK v2 GitHub repositories be deprecated?</h3>
</div>
<p>The GitHub repositories will be deprecated July 18, 2022.</p>
<div id="Question2">
<h3>I'm using the Universal Prompt, does this affect me?</h3>
</div>
<p>No. Duo is only deprecating the older, non-Universal Prompt Web SDK repositories (also known as the Web SDK v2 repositories).</p>
<div id="Question3">
<h3>How do I know if I'm using Web SDK v2 or the Universal Prompt?</h3>
</div>
<p>If the repository you are using begins with "duo_universal", it is a Universal Prompt repository and is not affected by this deprecation. It it begins with "duo_api" or "duo_client", that is an Auth API client and not affected by this deprecation. The affected Web SDK v2 repositories are listed below in the "Which GitHub repositories are being deprecated?" question.</p>
<div id="Question4">
<h3>Will my Web SDK v2 integrations still work?</h3>
</div>
<p>For now, yes, Web SDK v2 integrations will continue to function. This deprecation <i>only</i> applies to GitHub repositories for the older, Web SDK v2 clients. However, we recommend upgrading to the Universal Prompt for the improved user experience and additional features. Note that Duo has announced that the Traditional (iframe based) Prompt aka Web SDK v2 based integrations will reach <a href="https://help.duo.com/s/article/7839?language=en_US">end of life</a> on March 30, 2024.</p>
<div id="Question5">
<h3>Can I keep using the Web SDK v2 GitHub repositories after they are deprecated?</h3>
</div>
<p>Yes. The GitHub repositories will be archived, but remain public. You can still fork, clone, or pull from them; though as noted, it is unlikely they will receive any updates.</p>
<div id="Question6">
<h3>Can I still create Duo Web SDK v2 integrations that use the deprecated Web SDK v2 GitHub repositories?</h3>
</div>
<p>Yes. This deprecation does not change anything in the Duo cloud service.</p>
<div id="Question7">
<h3>Why is Duo deprecating the Web SDK v2 GitHub repositories?</h3>
</div>
<p>Duo only plans to implement new functionality in the Universal Prompt, and therefore strongly encourages that applications migrate away from the older Web SDK v2 clients to the Universal Prompt clients. We are deprecating the older GitHub repositories to communicate that they will not be in active development.</p>
<div id="Question8">
<h3>Which GitHub repositories are being deprecated?</h3>
</div>
<p>All repositories related to Web SDK v2 integrations that do not use the Universal Prompt. The full list is:</p>
<ul>
<li>duo_python</li>
<li>duo_java</li>
<li>duo_ruby</li>
<li>duo_perl</li>
<li>duo_dotnet</li>
<li>duo_nodejs</li>
<li>duo_php</li>
<li>duo_oam_plugin</li>
<li>duo_web_sdk</li>
<li>duo_coldfusion</li>
<li>duo_wordpress</li>
<li>duo_classicasp</li>
<li>duo_jira</li>
<li>duo_confluence</li>
<li>duo_splunk</li>
</ul>
<div id="Question9">
<h3>How do I upgrade an application to the Universal Prompt?</h3>
</div>
<p>There are a variety of options. Please see our <a href="https://duo.com/docs/universal-prompt-update-guide">Universal Prompt Update Guide</a> for an overview of the update process.</p>
<p>Duo has published multiple Universal Prompt client libraries, both to GitHub and online package managers:</p>
<ul>
<li><a href="https://github.com/duosecurity/duo_universal_python">Python</a></li>
<li><a href="https://pypi.org/project/duo-universal/">PyPi</a></li>
<li><a href="https://github.com/duosecurity/duo_universal_java">Java</a></li>
<li><a href="https://mvnrepository.com/artifact/com.duosecurity/duo-universal-sdk">Maven</a></li>
<li><a href="https://github.com/duosecurity/duo_universal_php">PHP</a></li>
<li><a href="https://packagist.org/packages/duosecurity/duo_universal_php">Packagist</a></li>
<li><a href="https://github.com/duosecurity/duo_universal_nodejs">NodeJS</a></li>
<li><a href="https://www.npmjs.com/package/@duosecurity/duo_universal">NPM</a></li>
<li><a href="https://github.com/duosecurity/duo_universal_csharp">C#</a></li>
<li><a href="https://www.nuget.org/packages/DuoUniversal/">NuGet</a></li>
<li><a href="https://github.com/duosecurity/duo_universal_golang">Golang</a></li>
</ul>
<p>You can find a step-by-step example of updating an existing Web SDK v2 application to the Universal Prompt <a href="https://github.com/duosecurity/duo_python/pull/57">here</a>.</p>
<p>Another option for web applications with OIDC support is to use our OIDC-based API. See our <a href="https://duo.com/docs/oauthapi">documentation</a> for more information.</p>
<p>And for web applications with SAML support, consider implementing the best of both worlds with <a href="https://duo.com/docs/sso">Duo Single Sign-On</a> and/or <a href="https://duo.com/docs/passwordless">Duo Passwordless</a></p>
<div id="Question10">
<h3>What does deprecation of the Web SDK v2 GitHub repositories mean?</h3>
</div>
<p>Primarily, it means no feature work is planned on the GitHub repositories. It is also unlikely that any new versions will be released, except in the case of significant security vulnerabilities being found. The GitHub repositories will be archived and no longer accept issue reports or pull requests.</p>
<div id="Question11">
<h3>What will happen to the Web SDK v2 packages in package managers, for example PyPi?</h3>
</div>
<p>These packages will be deprecated in the package managers. This generally means the packages will remain available for use, but will emit warnings about deprecation. The packages will not receive updates or new releases, except in the case of a significant security vulnerability.</p>
<p>This applies only to the older Web SDK v2 packages, not the Universal Prompt client packages - those continue to be supported. The packages in package managers that will be deprecated are:</p>
<ul>
<li><a href="https://pypi.org/project/duo-web/">Python / PyPi</a></li>
<li><a href="https://rubygems.org/gems/duo_web">Ruby / RubyGems</a></li>
<li><a href="https://www.npmjs.com/package/@duosecurity/duo_web">NodeJS / NPM</a></li>
<li><a href="https://packagist.org/packages/duosecurity/duo_php">PHP / Packagist</a></li>
</ul>
<div id="Question12">
<h3>What about Web SDK v2 GitHub repositories that don't have a Universal Prompt version? Like duo_ruby or duo_perl?</h3>
</div>
<p>Even though there are no replacements at this time, we will still be deprecating this category of repositories. To implement a Universal Prompt integration in one of these languages or applications, you can use the Duo OIDC Auth API described at <a href="https://duo.com/docs/oauthapi">https://duo.com/docs/oauthapi</a>.</p>
</div>
</div>
</body>
</html>