`secrets` --- 產生用於管理機密的安全亂數¶

在 3.6 版被加入.

原始碼：Lib/secrets.py

secrets 模組可用於產生高加密強度的亂數，適合用來管理諸如密碼、帳號認證、安全性權杖（security tokens）這類資料，以及管理其他相關的機密資料。

尤其應優先使用 secrets 作為預設來替代 random 模組中的預設偽亂數產生器（pseudo-random number generator），該模組被設計用於建模和模擬，而非用於安全性和加密。

也參考

亂數¶

secrets 模組使你得以存取作業系統所提供安全性最高的亂數產生器。

class secrets.SystemRandom¶: 一個用來產生亂數的類別，用的是作業系統提供的最高品質來源。請參閱 random.SystemRandom 以取得更多細節。

secrets.randbelow(exclusive_upper_bound)¶: 回傳一個 [0, exclusive_upper_bound) 範圍之內的隨機整數。

secrets 模組提供了一些產生安全性權杖的函式，適合用於諸如重設密碼、難以猜測的 URL，或類似的應用。

secrets.token_bytes(nbytes=None)¶

回傳一個隨機位元組字串，其中含有 nbytes 位元組的數字。

If nbytes is not specified or None, DEFAULT_ENTROPY is used instead.

>>> token_bytes(16)
b'\xebr\x17D*t\xae\xd4\xe3S\xb6\xe2\xebP1\x8b'

secrets.token_hex(nbytes=None)¶

回傳一以十六進位表示的隨機字串。字串具有 nbytes 個隨機位元組，每個位元組會轉成兩個十六進位的數字。

If nbytes is not specified or None, DEFAULT_ENTROPY is used instead.

>>> token_hex(16)
'f9bf78b9a18ce6d46a0cd2b0b86df9da'

secrets.token_urlsafe(nbytes=None)¶

回傳一個 URL 安全的隨機文本字串，包含 nbytes 個隨機位元組。文本將使用 Base64 編碼，因此平均來說每個位元組會對應到約 1.3 個字元。

If nbytes is not specified or None, DEFAULT_ENTROPY is used instead.

>>> token_urlsafe(16)
'Drmhze6EPcv0fN_81Bj-nA'

為了在面對暴力攻擊時能保證安全，權杖必須具有足夠的隨機性。不幸的是，對隨機性是否足夠的標準，會隨著電腦越來越強大並能夠在更短時間內進行更多猜測而不斷提高。在 2015 年時，人們認為 32 位元組（256 位元）的隨機性對於 secrets 模組所預期的一般使用場景來說是足夠的。

對於想自行管理權杖長度的使用者，你可以對各種 token_* 函式明白地指定 int 引數（argument）來指定權杖要使用的隨機性程度。該引數以位元組數來表示要使用的隨機性程度。

否則，如未提供引數，或者如果引數為 None，則 token_* 函式則會改用 DEFAULT_ENTROPY。