チェンジセット 1689 (default)

日時:

2024/09/13 2:33:19 (3週前)

更新者:

hizuya@…

ログメッセージ:

• base64url の機能を追加。

場所:

framework/trunk

ファイル:

• CoreLibrary/Sources/Security/SecurityUtility.cs (更新) (2個の差分)
• CoreLibrary/Sources/Text/TextUtility.cs (更新) (1個の差分)
• CoreTest/Sources/Text/TextUtilityTest.cs (更新) (1個の差分)

framework/trunk/CoreLibrary/Sources/Security/SecurityUtility.cs

@@ -37 +37 @@
     using System.Web.Security;
     using FCSoft.SilverFrost.Framework.Properties;
+    using FCSoft.SilverFrost.Framework.Text;
 
 
@@ -102 +103 @@
 
             // base64 url encoding に準拠
-            return Convert.ToBase64String(hashedData).Replace('+', '-').Replace('/', '_').TrimEnd('=');
+            return TextUtility.EncodeBase64Url(hashedData, true);
         }
 

framework/trunk/CoreLibrary/Sources/Text/TextUtility.cs

@@ -843 +843 @@
 
             return buffer;
+        }
+
+        /// <summary>
+        /// <c>base64url</c> エンコーディングを行います。
+        /// </summary>
+        /// <param name="inArray">エンコードするデータ。</param>
+        /// <param name="trimPadding">
+        /// 末尾のパディング文字を削除する場合は <see langword="true"/>。
+        /// それ以外の場合は <see langword="false"/>。
+        /// </param>
+        /// <returns>
+        /// <c>base64url</c> エンコードした文字列。
+        /// </returns>
+        /// <exception cref="ArgumentNullException">
+        /// <paramref name="inArray"/> が <see langword="null"/> 参照です。
+        /// </exception>
+        public static string EncodeBase64Url(byte[] inArray, bool trimPadding)
+        {
+            return EncodeBase64Url(
+                inArray,
+                0,
+                // ReSharper disable once ExceptionNotDocumented
+                inArray != null ? inArray.Length : 0,
+                trimPadding);
+        }
+
+        /// <summary>
+        /// <c>base64url</c> エンコーディングを行います。
+        /// </summary>
+        /// <param name="inArray">エンコードするデータ。</param>
+        /// <param name="offset"><paramref name="inArray"/> のオフセット。</param>
+        /// <param name="length">変換する <paramref name="inArray"/> の要素数。</param>
+        /// <param name="trimPadding">
+        /// 末尾のパディング文字を削除する場合は <see langword="true"/>。
+        /// それ以外の場合は <see langword="false"/>。
+        /// </param>
+        /// <returns>
+        /// <c>base64url</c> エンコードした文字列。
+        /// </returns>
+        /// <exception cref="ArgumentNullException">
+        /// <paramref name="inArray"/> が <see langword="null"/> 参照です。
+        /// </exception>
+        public static string EncodeBase64Url(byte[] inArray, int offset, int length, bool trimPadding)
+        {
+            string base64 = Convert.ToBase64String(inArray, offset, length).Replace('+', '-').Replace('/', '_');
+            return trimPadding ? base64.TrimEnd('=') : base64;
+        }
+
+        /// <summary>
+        /// <c>base64url</c> デコードを行います。
+        /// </summary>
+        /// <param name="value"><c>base64url</c> エンコードした文字列。</param>
+        /// <returns>
+        /// <c>base64url</c> デコードしたデータ。
+        /// </returns>
+        /// <exception cref="ArgumentNullException">
+        /// <paramref name="value"/> が <see langword="null"/> 参照です。
+        /// </exception>
+        public static byte[] DecodeBase64Url(string value)
+        {
+            // 引数をチェック
+            if (value == null)
+            {
+                throw new ArgumentNullException("value");
+            }
+
+            string base64 = value.Replace('-', '+').Replace('_', '/');
+            int paddingLength = base64.Length % 4;
+            if (paddingLength > 0)
+            {
+                base64 = base64.PadRight(base64.Length + (4 - paddingLength), '=');
+            }
+
+            return Convert.FromBase64String(base64);
         }
 

framework/trunk/CoreTest/Sources/Text/TextUtilityTest.cs

@@ -358 +358 @@
 
         /// <summary>
+        /// <see cref="TextUtility.EncodeBase64Url(byte[], bool)"/> をテストします。
+        /// </summary>
+        /// <param name="inArray">エンコードするデータを表す16進数の文字列。</param>
+        /// <param name="trimPadding">
+        /// 末尾のパディング文字を削除する場合は <see langword="true"/>。
+        /// それ以外の場合は <see langword="false"/>。
+        /// </param>
+        /// <returns>
+        /// <see cref="TextUtility.EncodeBase64Url(byte[], bool)"/> の戻り値。
+        /// </returns>
+        [Test]
+        [TestCase("", false, ExpectedResult = "")]
+        [TestCase("00", false, ExpectedResult = "AA==")]
+        [TestCase("00", true, ExpectedResult = "AA")]
+        [TestCase("0123456789ABCDEF", false, ExpectedResult = "ASNFZ4mrze8=")]
+        [TestCase("0123456789ABCDEF", true, ExpectedResult = "ASNFZ4mrze8")]
+        [TestCase("00108310518720928B30D38F41149351559761969B71D79F8218A39259A7A29AABB2DBAFC31CB3D35DB7E39EBBF3DFBF", false, ExpectedResult = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_")]
+        public string TestEncodeBase64Url(string inArray, bool trimPadding)
+        {
+            return TextUtility.EncodeBase64Url(
+                TextUtility.ConvertHexToBinary(inArray),
+                trimPadding);
+        }
+
+        /// <summary>
+        /// <see cref="TextUtility.EncodeBase64Url(byte[], int, int, bool)"/> をテストします。
+        /// </summary>
+        /// <param name="inArray">エンコードするデータを表す16進数の文字列。</param>
+        /// <param name="offset"><paramref name="inArray"/> のオフセット。</param>
+        /// <param name="length">変換する <paramref name="inArray"/> の要素数。</param>
+        /// <param name="trimPadding">
+        /// 末尾のパディング文字を削除する場合は <see langword="true"/>。
+        /// それ以外の場合は <see langword="false"/>。
+        /// </param>
+        /// <returns>
+        /// <see cref="TextUtility.EncodeBase64Url(byte[], int, int, bool)"/> の戻り値。
+        /// </returns>
+        [Test]
+        [TestCase("", 0, 0, false, ExpectedResult = "")]
+        [TestCase("00", 0, 1, false, ExpectedResult = "AA==")]
+        [TestCase("00", 0, 1, true, ExpectedResult = "AA")]
+        [TestCase("0123456789ABCDEF", 0, 8, false, ExpectedResult = "ASNFZ4mrze8=")]
+        [TestCase("0123456789ABCDEF", 0, 8, true, ExpectedResult = "ASNFZ4mrze8")]
+        [TestCase("0123456789ABCDEF", 0, 0, true, ExpectedResult = "")]
+        [TestCase("0123456789ABCDEF", 0, 1, true, ExpectedResult = "AQ")]
+        [TestCase("0123456789ABCDEF", 1, 6, true, ExpectedResult = "I0VniavN")]
+        [TestCase("0123456789ABCDEF", 7, 1, true, ExpectedResult = "7w")]
+        [TestCase("0123456789ABCDEF", 8, 0, true, ExpectedResult = "")]
+        public string TestEncodeBase64Url(string inArray, int offset, int length, bool trimPadding)
+        {
+            return TextUtility.EncodeBase64Url(
+                TextUtility.ConvertHexToBinary(inArray),
+                offset,
+                length,
+                trimPadding);
+        }
+
+        /// <summary>
+        /// <see cref="TextUtility.DecodeBase64Url"/> をテストします。
+        /// </summary>
+        /// <param name="value"><c>base64url</c> エンコードした文字列。</param>
+        /// <returns>
+        /// <see cref="TextUtility.DecodeBase64Url"/> の戻り値を表す16進数の文字列。
+        /// </returns>
+        [Test]
+        [TestCase("", ExpectedResult = "")]
+        [TestCase("AA==", ExpectedResult = "00")]
+        [TestCase("AA", ExpectedResult = "00")]
+        [TestCase("ASNFZ4mrze8=", ExpectedResult = "0123456789ABCDEF")]
+        [TestCase("ASNFZ4mrze8", ExpectedResult = "0123456789ABCDEF")]
+        [TestCase(@"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_", ExpectedResult = "00108310518720928B30D38F41149351559761969B71D79F8218A39259A7A29AABB2DBAFC31CB3D35DB7E39EBBF3DFBF")]
+        public string TestDecodeBase64Url(string value)
+        {
+            return TextUtility.ConvertToHexString(
+                TextUtility.DecodeBase64Url(value));
+        }
+
+        /// <summary>
         /// <see cref="TextUtility.ApplyFixedWidthWordWrap"/> をテストします。
         /// </summary>