在實際環境中測試
在生產環境中測試無浮水印。
在任何需要的地方都能運作。
全功能產品
獲得30天完全功能的產品。
幾分鐘內即可啟動並運行。
24/5技術支援
試用產品期間完全訪問我們的支援工程團隊
節點幫助
oauth2orize NPM（對開發者的運作方式）
發佈 2024年10月24日
介紹
動態內容創建和強大的安全性對於當今的網頁應用程序至關重要。通過允許應用程序在不透露憑證的情況下代表用戶提供受限或有限的資源訪問，OAuth2.0已成為安全授權的實際框架。 靈活的 Node.js 模組 OAuth2orize 提供了一個強大的框架，用於管理安全的基於訪問令牌的身份驗證，這使得 OAuth 2.0 授權伺服器的設置更加簡便。
同時，在包括報告生產和發票系統等多個領域的典型需求是能夠以編程方式生成和處理PDF文件。 在 Node.js 環境中，強大的工具 IronPDF 簡化了 PDF 文件的生成、編輯和渲染。
本教程通過結合IronPDF和OAuth2orize的最佳功能，構建一個動態且安全的Node.js應用程式。您將學習如何通過配置OAuth2orize中的OAuth 2.0伺服器來處理用戶身份驗證和授權。您還將學習如何使用IronPDF創建需要身份驗證的API端點可訪問的PDF文檔。
OAuth2orize 是什麼？
一個名為 Node.js 的框架OAuth2orize為開發人員提供建立 OAuth 2.0 授權伺服器所需的資源。 它幫助處理和管理複雜的 OAuth 2.0 工作流程，其中包括刷新令牌的創建、驗證和管理。 由於此函式庫是設計來與 Express 框架互動，因此已經熟悉 Express 的開發人員會覺得它是個自然的搭配。
OAuth2orize 的詳細功能和組件
授權類型支援
授權碼授予最適合用於伺服器端應用程序，其中授權碼可以被客戶端安全地存儲，然後用於交換訪問令牌。
- 隱式授權：適用於客戶端程序，例如單頁應用程式，客戶端可以立即獲得訪問令牌。
- 資源擁有者密碼憑證授權：通常應用於第一方客戶，當資源擁有者和客戶具有信任關係時，這種方式非常有幫助。
客戶端憑證授權：用於機器之間的交互(伺服器和客戶端)客戶需要使用 API 請求進行身份驗證以接收訪問權杖。
中介軟體整合
- Express 中介軟體：OAuth2orize 輕鬆整合到 Express 的路由和中介軟體架構中，作為 Express 應用程式中的中介軟體運行。
與 Passport.js 的整合：OAuth2orize 無縫整合了 Passport.js，這是一個功能豐富的 Node.js 認證中介軟體，讓開發人員除了 OAuth 2.0 之外，還可以使用各種認證技術。
令牌管理
- 訪問權杖：授予資源訪問權限的臨時權杖受到限制。
刷新令牌：這些是更長時間有效的令牌，允許用戶在不必重新驗證的情況下獲取新的訪問令牌。
自訂授權和擴充功能
由於 OAuth2orize 的高度適應性，開發者可以構建定制的授權類型和響應類型，以滿足特定應用程序的需求。
值得記住的安全要點
OAuth2orize安全地管理令牌的發行、驗證和撤銷，促進安全的OAuth 2.0應用程序。 建議開發者遵循 OAuth 2.0 的最佳實踐，包括使用 HTTPS、驗證重定向 URI，以及將令牌存儲在安全的位置。
創建和配置 OAuth2orize
按照以下說明，在 Node.js 中使用 OAuth2orize 設置和建立 OAuth 2.0 授權伺服器。我們將定義授權類型，建立用於授權和令牌交換的 API，並設置一個授權伺服器。 在此配置中，用戶驗證將使用 Passport.js、OAuth2orize 和 Express。
安裝相依性
首先，初始化您的 Node.js 專案並安裝必要的相依套件。
npm install express
npm install oauth2orize
npm install passport
npm install passport-local
npm install passport-http
npm install body-parser
npm install passport-http-bearer
npm install express-session uuid
npm install connect-ensure-loginnpm install express
npm install oauth2orize
npm install passport
npm install passport-local
npm install passport-http
npm install body-parser
npm install passport-http-bearer
npm install express-session uuid
npm install connect-ensure-login'INSTANT VB TODO TASK: The following line uses invalid syntax:
'npm install express npm install oauth2orize npm install passport npm install passport-local npm install passport-http npm install body-parser npm install passport-http-bearer npm install express-session uuid npm install connect-ensure-loginVB C#
建立授權伺服器
要配置伺服器，請建立一個名為 server.js 的檔案，並將以下代碼添加到其中：
const express = require('express');
const oauth2orize = require('oauth2orize');
const passport = require('passport');
const LocalStrategy = require('passport-local').Strategy;
const BasicStrategy = require('passport-http').BasicStrategy;
const BearerStrategy = require('passport-http-bearer').Strategy;
const bodyParser = require('body-parser');
const session = require('express-session');
const { v4: uuidv4 } = require('uuid');
// In-memory data storage (use a database in production)
const users = [{ id: '1', username: 'user', password: 'pass' }];
const clients = [{ id: 'client', secret: 'secret', redirectUris: ['http://localhost:3000/cb'] }];
const tokens = [];
// Passport configuration
passport.serializeUser((user, done) => done(null, user.id));
passport.deserializeUser((id, done) => {
const user = users.find(user => user.id === id);
done(null, user);
});
passport.use(new LocalStrategy((username, password, done) => {
const user = users.find(user => user.username === username && user.password === password);
if (user) return done(null, user);
return done(null, false);
}));
passport.use(new BasicStrategy((clientId, clientSecret, done) => {
const client = clients.find(client => client.id === clientId && client.secret === clientSecret);
if (client) return done(null, client);
return done(null, false);
}));
passport.use(new BearerStrategy((token, done) => {
const accessToken = tokens.find(t => t.accessToken === token);
if (accessToken) {
const user = users.find(user => user.id === accessToken.userId);
if (user) return done(null, user);
}
return done(null, false);
}));
// Create OAuth 2.0 server
const server = oauth2orize.createServer();
// Grant authorization codes
server.grant(oauth2orize.grant.code((client, redirectUri, user, ares, done) => {
const code = uuidv4();
tokens.push({ code, clientId: client.id, redirectUri, userId: user.id });
done(null, code);
}));
// Exchange codes for user granting access tokens
server.exchange(oauth2orize.exchange.code((client, code, redirectUri, done) => {
const token = tokens.find(t => t.code === code && t.clientId === client.id && t.redirectUri === redirectUri);
if (!token) return done(null, false);
const accessToken = uuidv4();
tokens.push({ accessToken, userId: token.userId, clientId: client.id });
done(null, accessToken);
}));
// Express application setup
const app = express();
app.use(bodyParser.urlencoded({ extended: true }));
app.use(session({ secret: 'secret', resave: false, saveUninitialized: false }));
app.use(passport.initialize());
app.use(passport.session());
// Authorization endpoint
app.get('/authorize', (req, res) => {
res.send('<form action="/authorize/decision" method="post"><button type="submit">Allow</button></form>');
});
app.post('/authorize/decision', (req, res, next) => {
server.decision()(req, res, next);
});
// Token endpoint
app.post('/token',
passport.authenticate('basic', { session: false }),
server.token(),
server.errorHandler()
);
// Protected resource endpoint
app.get('/resource', passport.authenticate('bearer', { session: false }), (req, res) => {
res.json({ message: 'Access granted to protected resource!' });
});
// Start the server
const port = 3000;
app.listen(port, () => {
console.log(`OAuth2orize server is running on http://localhost:${port}`);
});const express = require('express');
const oauth2orize = require('oauth2orize');
const passport = require('passport');
const LocalStrategy = require('passport-local').Strategy;
const BasicStrategy = require('passport-http').BasicStrategy;
const BearerStrategy = require('passport-http-bearer').Strategy;
const bodyParser = require('body-parser');
const session = require('express-session');
const { v4: uuidv4 } = require('uuid');
// In-memory data storage (use a database in production)
const users = [{ id: '1', username: 'user', password: 'pass' }];
const clients = [{ id: 'client', secret: 'secret', redirectUris: ['http://localhost:3000/cb'] }];
const tokens = [];
// Passport configuration
passport.serializeUser((user, done) => done(null, user.id));
passport.deserializeUser((id, done) => {
const user = users.find(user => user.id === id);
done(null, user);
});
passport.use(new LocalStrategy((username, password, done) => {
const user = users.find(user => user.username === username && user.password === password);
if (user) return done(null, user);
return done(null, false);
}));
passport.use(new BasicStrategy((clientId, clientSecret, done) => {
const client = clients.find(client => client.id === clientId && client.secret === clientSecret);
if (client) return done(null, client);
return done(null, false);
}));
passport.use(new BearerStrategy((token, done) => {
const accessToken = tokens.find(t => t.accessToken === token);
if (accessToken) {
const user = users.find(user => user.id === accessToken.userId);
if (user) return done(null, user);
}
return done(null, false);
}));
// Create OAuth 2.0 server
const server = oauth2orize.createServer();
// Grant authorization codes
server.grant(oauth2orize.grant.code((client, redirectUri, user, ares, done) => {
const code = uuidv4();
tokens.push({ code, clientId: client.id, redirectUri, userId: user.id });
done(null, code);
}));
// Exchange codes for user granting access tokens
server.exchange(oauth2orize.exchange.code((client, code, redirectUri, done) => {
const token = tokens.find(t => t.code === code && t.clientId === client.id && t.redirectUri === redirectUri);
if (!token) return done(null, false);
const accessToken = uuidv4();
tokens.push({ accessToken, userId: token.userId, clientId: client.id });
done(null, accessToken);
}));
// Express application setup
const app = express();
app.use(bodyParser.urlencoded({ extended: true }));
app.use(session({ secret: 'secret', resave: false, saveUninitialized: false }));
app.use(passport.initialize());
app.use(passport.session());
// Authorization endpoint
app.get('/authorize', (req, res) => {
res.send('<form action="/authorize/decision" method="post"><button type="submit">Allow</button></form>');
});
app.post('/authorize/decision', (req, res, next) => {
server.decision()(req, res, next);
});
// Token endpoint
app.post('/token',
passport.authenticate('basic', { session: false }),
server.token(),
server.errorHandler()
);
// Protected resource endpoint
app.get('/resource', passport.authenticate('bearer', { session: false }), (req, res) => {
res.json({ message: 'Access granted to protected resource!' });
});
// Start the server
const port = 3000;
app.listen(port, () => {
console.log(`OAuth2orize server is running on http://localhost:${port}`);
});const express = require( 'express');
const oauth2orize = require( 'oauth2orize');
const passport = require( 'passport');
const LocalStrategy = require( 'passport-local').Strategy;
const BasicStrategy = require( 'passport-http').BasicStrategy;
const BearerStrategy = require( 'passport-http-bearer').Strategy;
const bodyParser = require( 'body-parser');
const session = require( 'express-session');
'INSTANT VB TODO TASK: The following line could not be converted:
const
If True Then
v4:
uuidv4 } = require( 'uuid');
' In-memory data storage (use a database in production)
const users = ({ id: "1"c, username: 'user', password: 'pass' }];
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'const clients = [{ id: 'client', secret: 'secret', redirectUris: ['http: const tokens = []; passport.serializeUser((user, done) => done(Nothing, user.id)); passport.deserializeUser((id, done) => { const user = users.find(user => user.id === id); done(Nothing, user); }); passport.use(New LocalStrategy((username, password, done) => { const user = users.find(user => user.username === username && user.password === password); if(user) Return done(Nothing, user); Return done(Nothing, False); })); passport.use(New BasicStrategy((clientId, clientSecret, done) => { const client = clients.find(client => client.id === clientId && client.secret === clientSecret); if(client) Return done(Nothing, client); Return done(Nothing, False); })); passport.use(New BearerStrategy((token, done) => { const accessToken = tokens.find(t => t.accessToken === token); if(accessToken) { const user = users.find(user => user.id === accessToken.userId); if(user) Return done(Nothing, user); } Return done(Nothing, False); })); const server = oauth2orize.createServer(); server.grant(oauth2orize.grant.code((client, redirectUri, user, ares, done) => { const code = uuidv4(); tokens.push({ code, clientId: client.id, redirectUri, userId: user.id }); done(Nothing, code); })); server.exchange(oauth2orize.exchange.code((client, code, redirectUri, done) => { const token = tokens.find(t => t.code === code && t.clientId === client.id && t.redirectUri === redirectUri); if(!token) Return done(Nothing, False); const accessToken = uuidv4(); tokens.push({ accessToken, userId: token.userId, clientId: client.id }); done(Nothing, accessToken); })); const app = express(); app.use(bodyParser.urlencoded({ extended: True })); app.use(session({ secret: 'secret', resave: False, saveUninitialized: False })); app.use(passport.initialize()); app.use(passport.session()); app.@get('/authorize', (req, res) => { res.send('<form action="/authorize/decision" method="post"><button type="submit"> Allow</button></form>'); }); app.post('/authorize/decision', (req, res, @next) => { server.decision()(req, res, @next); }); app.post('/token', passport.authenticate('basic', { session: False }), server.token(), server.errorHandler()); app.@get('/resource', passport.authenticate('bearer', { session: False }), (req, res) => { res.json({ message: 'Access granted @to protected resource!' }); }); const port = 3000; app.listen(port, () => { console.log(`OAuth2orize server is running on http: });VB C#
您已成功在 Node.js 中使用 OAuth2orize，通過以下步驟建立並配置 OAuth 2.0 授權伺服器。 此配置說明如何管理授權碼的授權，將其轉換為存取權杖，並使用承擔者權杖來保護 API 端點。 考慮在生產環境中實施適當的錯誤處理、保護敏感數據，並將用戶、客戶端和令牌存儲在耐用的數據庫中。
入門
要在 Node.js 應用程式中整合 OAuth2orize 與 IronPDF，首先必須使用 OAuth2orize 建立一個 OAuth 2.0 授權伺服器，並使用 IronPDF 實現 PDF 生成。 以下是協助您達成此目標的詳細教程。
什麼是 IronPDF?
IronPDF是一組應用程式庫，旨在更輕鬆地創建、修改和組織 PDF 文件。 開發人員可以新增標頭和浮水印、合併多個 PDF 頁面、從 HTML 文件中提取文本和圖像，及使用此工具執行多項其他任務。 IronPDF 的用户友好型 API 和详尽的文档使开发人员能够轻松自动创建高质量的 PDF 文档。 IronPDF 擁有所有增強文件流程和提供優秀用戶體驗所需的功能和能力，適用於各種情境，包括發票、報告和文檔的創建。
IronPDF 的功能
將 HTML 轉換為 PDF 是處理任何類型 HTML 文本（包括 CSS 和 JavaScript）的快速簡便方法。
PDF 文件合併：將多個 PDF 文件合併為一個單一的 PDF 文件，以簡化文件管理任務。
文字與圖像提取：從 PDF 文件中提取文字和圖像，以便您進行進一步的分析或數據處理。
水印：您可以將文字或圖片水印應用於 PDF 頁面，以達到品牌宣傳或安全目的。
包含頁眉和頁腳：您可以在 PDF 文件的頁眉和頁腳中添加個人訊息或頁碼。
安裝 IronPDF
要啟用 IronPDF 功能，請使用 Node 套件管理器安裝必要的 Node.js 套件。
npm install @ironsoftware/ironpdfnpm install @ironsoftware/ironpdf'INSTANT VB TODO TASK: The following line uses invalid syntax:
'npm install @ironsoftware/ironpdfVB C#
將 OAuth2orize Node.js 與 IronPDF 整合
將以下程式碼添加到 OAuth 2.0 授權伺服器程式碼中，以整合 IronPDF 進行 PDF 生成。
const IronPdf = require("@ironsoftware/ironpdf");
const document=IronPdf.PdfDocument;
var config=IronPdf.IronPdfGlobalConfig
// Protected resource endpoint to generate PDF
app.get('/generate-pdf', passport.authenticate('bearer', { session: false }), async (req, res) => {
const pdf = new IronPDF();
// Example HTML content for PDF generation
const htmlContent = `
<html>
<head>
<title>PDF Report</title>
</head>
<body>
<h1>Secure PDF Report</h1>
<p>This PDF was generated by Ironpdf.</p>
</body>
</html>
`;
try {
const pdf = (await document.fromHtml(htmlContent));
const pdfBuffer=await pdf.saveAsBuffer();
res.writeHead(200, {
'Content-Type': 'application/pdf',
'Content-Disposition': 'attachment; filename=report.pdf',
'Content-Length': pdfBuffer.length
});
res.end(pdfBuffer);
} catch (error) {
res.status(500).send('Error generating PDF');
}
});const IronPdf = require("@ironsoftware/ironpdf");
const document=IronPdf.PdfDocument;
var config=IronPdf.IronPdfGlobalConfig
// Protected resource endpoint to generate PDF
app.get('/generate-pdf', passport.authenticate('bearer', { session: false }), async (req, res) => {
const pdf = new IronPDF();
// Example HTML content for PDF generation
const htmlContent = `
<html>
<head>
<title>PDF Report</title>
</head>
<body>
<h1>Secure PDF Report</h1>
<p>This PDF was generated by Ironpdf.</p>
</body>
</html>
`;
try {
const pdf = (await document.fromHtml(htmlContent));
const pdfBuffer=await pdf.saveAsBuffer();
res.writeHead(200, {
'Content-Type': 'application/pdf',
'Content-Disposition': 'attachment; filename=report.pdf',
'Content-Length': pdfBuffer.length
});
res.end(pdfBuffer);
} catch (error) {
res.status(500).send('Error generating PDF');
}
});const IronPdf = require("@ironsoftware/ironpdf")
const document=IronPdf.PdfDocument
Dim config=IronPdf.IronPdfGlobalConfig app.get( '/generate-pdf', passport.authenticate('bearer', { session: False }), async(req, res) =>
If True Then
const pdf = New IronPDF()
const htmlContent = ` (Of html) (Of head) (Of title) PDF Report</title> </head> (Of body) (Of h1) Secure PDF Report</h1> (Of p) This PDF was generated by Ironpdf.</p> </body> </html> `
Try
const pdf = (Await document.fromHtml(htmlContent))
const pdfBuffer=Await pdf.saveAsBuffer()
res.writeHead(200, { 'Content-Type': 'application/pdf', 'Content-Disposition': 'attachment; filename=report.pdf', 'Content-Length': pdfBuffer.length });
res.end(pdfBuffer)
Catch e1 As [error]
res.status(500).send( '@Error generating PDF');
End Try
End If
)VB C#
所提供的程式碼展示了如何在 Node.js 中整合 IronPDF 進行動態 PDF 生成，並使用 OAuth2orize 建立一個 OAuth 2.0 授權伺服器。 必要的依賴項，如 Express、Passport 和 UUID，已包含在設置中。為了簡單起見，用戶和客戶端保存在內存陣列中； 然而，在生產環境中應該使用數據庫。
該程式碼透過定義多種 Passport 技術來處理客戶端驗證和用戶身份驗證。 授權碼授權流程中，使用者允許客戶端代表他們存取資源，這是由 OAuth2orize 處理的。客戶端在獲取授權碼後，可以將其交換為存取令牌。 由於使用了 Bearer token 技術來保護 /generate-pdf 端點，僅允許經過身份驗證的請求來創建 PDF。
端點使用IronPDF將HTML內容轉換為一個PDF文檔，然後返回給客戶端。 此整合提供如何使用 OAuth 2.0 來保護 API 端點並以可擴展且安全的方式交付動態內容的範例。
結論
總之，在 Node.js 應用程式中使用 OAuth2orize 和 IronPDF 能夠穩固且安全地生成高品質的 PDF。 由於 OAuth2orize 提供強大的 OAuth 2.0 授權，敏感數據受到保護，保證只有授權和認證的用戶才能使用 PDF 創建服務。 另一方面，IronPDF 可輕鬆有效地將 HTML 資訊轉換為專業品質的 PDF 檔案。
此整合為開發者提供可擴展且簡單易行的解決方案，同時提高安全性、靈活性和用戶體驗。 借助這些技術，開發者可以製作符合現代安全性和功能標準的應用程式，這些應用程式兼具使用者友好性、可靠性和安全性。
通過將IronPDF和Iron Software技術添加到您的企業應用程序開發堆疊中，IronPDF可以為客戶和最終用戶確保功能豐富的高端軟體解決方案。 此外，這一堅實的基礎將使倡議、後端系統和流程優化變得更加容易。 IronPDF的價格為 $749。這些技術因為有詳細的文件說明、活躍的線上開發者社群，以及定期的升級，是現代軟體開發專案的絕佳選擇。
