identityserver4源碼解析_2_元數據介面

来源:https://www.cnblogs.com/holdengong/archive/2020/03/27/12580738.html
-Advertisement-
Play Games

目錄 "identityserver4源碼解析_1_項目結構" "identityserver4源碼解析_2_元數據介面" "identityserver4源碼解析_3_認證介面" "identityserver4源碼解析_4_令牌發放介面" "identityserver4源碼解析_5_查詢用戶信 ...


目錄

協議

這一系列我們都採用這樣的方式，先大概看下協議，也就是需求描述，然後看idsv4怎麼實現的，這樣可以加深理解。
元數據介面的協議地址如下：

https://openid.net/specs/openid-connect-discovery-1_0.html

摘要

該協議定義了一套標準，用戶能夠獲取到oidc服務的基本信息，包括OAuth2.0相關介面地址。

Webfinger - 網路指紋

先瞭解一下Webfinger這個概念。

WebFinger可以翻譯成網路指紋，它定義了一套標準，描述如何通過標準的HTTP方法去獲取網路實體的資料信息。WebFinger使用JSON來描述實體信息。

https://tools.ietf.org/html/rfc7033

查詢oidc服務元數據 - OpenID Provider Issuer Discovery

可選協議。
定義瞭如何獲取oidc服務元數據。如果客戶端明確知道oidc服務的地址，可以跳過此部分。
個人理解是存在多個oidc服務的情況，可以部署一個webfinger服務，根據資源請求，路由到不同的oidc服務。
通常來說，我們只有一個oidc服務，我看了一下idsv4也沒有實現這一部分協議，這裡瞭解一下就可以了。

查詢oidc服務配置信息 - OpenID Provider Configuration Request

必選協議。
用於描述oidc服務各介面地址及其他配置信息。

  GET /.well-known/openid-configuration HTTP/1.1
  Host: example.com

必須校驗issuer與請求地址是否一致

啟個idsrv服務調用試一下，返回結果如圖
image

詳細信息如下。

{
    "issuer": "https://localhost:10000", //頒發者地址
    "jwks_uri": "https://localhost:10000/.well-known/openid-configuration/jwks", //jwks介面地址，查詢密鑰
    "authorization_endpoint": "https://localhost:10000/connect/authorize", //認證介面地址
    "token_endpoint": "https://localhost:10000/connect/token", //令牌發放介面
    "userinfo_endpoint": "https://localhost:10000/connect/userinfo", //查詢用戶信息介面
    "end_session_endpoint": "https://localhost:10000/connect/endsession", //結束會話介面
    "check_session_iframe": "https://localhost:10000/connect/checksession", //檢查會話介面
    "revocation_endpoint": "https://localhost:10000/connect/revocation", //撤銷令牌介面
    "introspection_endpoint": "https://localhost:10000/connect/introspect", //查詢令牌詳情介面
    "device_authorization_endpoint": "https://localhost:10000/connect/deviceauthorization", //設備認證介面
    "frontchannel_logout_supported": true, //是否支持前端登出
    "frontchannel_logout_session_supported": true, //是否支持前端結束會話
    "backchannel_logout_supported": true, //是否支持後端登出
    "backchannel_logout_session_supported": true, //是否支持後端結束會話
    "scopes_supported": [ //支持的授權範圍,scope
        "openid",
        "profile",
        "userid",
        "username",
        "email",
        "mobile",
        "api",
        "offline_access" //token過期可用refresh_token刷新換取新token
    ],
    "claims_supported": [ //支持的聲明
        "sub",
        "updated_at",
        "locale",
        "zoneinfo",
        "birthdate",
        "gender",
        "preferred_username",
        "picture",
        "profile",
        "nickname",
        "middle_name",
        "given_name",
        "family_name",
        "website",
        "name",
        "userid",
        "username",
        "email",
        "mobile"
    ],
    "grant_types_supported": [ //支持的認證類型
        "authorization_code", //授權碼模式
        "client_credentials", //客戶端密鑰模式
        "refresh_token", //刷新token
        "implicit", //隱式流程, 一般用於單頁應用javascript客戶端
        "password", //用戶名密碼模式
        "urn:ietf:params:oauth:grant-type:device_code" //設備授權碼
    ],
    "response_types_supported": [ //支持的返回類型
        "code", //授權碼 
        "token", //通行令牌
        "id_token", //身份令牌
        "id_token token", //身份令牌+統通行令牌
        "code id_token", //授權碼+身份令牌
        "code token", //授權碼+通行令牌
        "code id_token token" //授權碼+身份令牌+通行令牌
    ],
    "response_modes_supported": [ //支持的響應方法
        "form_post", //form-post提交
        "query", //get提交
        "fragment" //fragment提交
    ],
    "token_endpoint_auth_methods_supported": [ //發放令牌介面支持的認證方式
        "client_secret_basic", //basic
        "client_secret_post" //post
    ],
    "id_token_signing_alg_values_supported": [ //身份令牌加密演算法
        "RS256"
    ],
    "subject_types_supported": [
        "public"
    ],
    "code_challenge_methods_supported": [
        "plain",
        "S256"
    ],
    "request_parameter_supported": true
}

JWK - Json Web Keys

idsv還註入這樣一個介面：DiscoveryKeyEndpoint，嘗試發現返回了一組密鑰。協議內容如下。

https://tools.ietf.org/html/draft-ietf-jose-json-web-key-41

GET /.well-known/openid-configuration/jwks，返回結果如下

{
    "keys": [
        {
            "kty": "RSA",
            "use": "sig",
            "kid": "LS-EQOr-3BkalkkUVh8q7Q",
            "e": "AQAB",
            "n": "08BLLaTz4JrTYmE4bZ9c7oKVrZKLy3KfGT5mmnslhl41nk_EV_8OUdL8wMXunC2KERdnsy5XYk4aw3LlvxZDIvjxO9PEblPsoap-WErdi9GVyAv-NJ6eJQy3S7FRSkvzQYBsLnCKm5wu0kjdQBVUCFJ7wfiZ9ayY7pH7K10qN2Utvt-qsCLUy0cJ0StuP_rquefp7_XhUw3A8IIA8P6DjfZIbpwrVjOeVWoI_ZKIwfxShghOAKBDLyQuC2PhozsqZ7HvGEeAPm06YPMWQVbE9_LBn2j_Ul_VBUWc9KfBNOzk_BMQHyF2NUlwMtqMUEcwK_hpjEeo62O_aFT8EDkgcQ",
            "alg": "RS256"
        },
        {
            "kty": "RSA",
            "use": "sig",
            "kid": "LS-EQOr-3BkalkkUVh8q7Q",
            "e": "AQAB",
            "n": "08BLLaTz4JrTYmE4bZ9c7oKVrZKLy3KfGT5mmnslhl41nk_EV_8OUdL8wMXunC2KERdnsy5XYk4aw3LlvxZDIvjxO9PEblPsoap-WErdi9GVyAv-NJ6eJQy3S7FRSkvzQYBsLnCKm5wu0kjdQBVUCFJ7wfiZ9ayY7pH7K10qN2Utvt-qsCLUy0cJ0StuP_rquefp7_XhUw3A8IIA8P6DjfZIbpwrVjOeVWoI_ZKIwfxShghOAKBDLyQuC2PhozsqZ7HvGEeAPm06YPMWQVbE9_LBn2j_Ul_VBUWc9KfBNOzk_BMQHyF2NUlwMtqMUEcwK_hpjEeo62O_aFT8EDkgcQ",
            "alg": "RS256"
        }
    ]
}

源碼解析

介面地址都在Constants.cs這個文件，ProtocalRoutePaths這個類裡面定義的。現在知道為什麼介面地址是.well-known/openid-configuration這樣奇怪的一個路由了，這是oidc協議定的（對，都是產品的鍋）。

image

oidc服務配置信息介面 - DiscoveryEndpoint

代碼很長，但是邏輯很簡單，就是組裝協議規定的所有地址和信息。
需要註意的支持的claims、支持的scope等信息是遍歷所有IdentityResource、ApiResource動態獲取的。
基本上每個介面都可以配置是否顯示在元數據文檔中。

public async Task<IEndpointResult> ProcessAsync(HttpContext context)
{
    _logger.LogTrace("Processing discovery request.");

    // validate HTTP
    if (!HttpMethods.IsGet(context.Request.Method))
    {
        _logger.LogWarning("Discovery endpoint only supports GET requests");
        return new StatusCodeResult(HttpStatusCode.MethodNotAllowed);
    }

    _logger.LogDebug("Start discovery request");

    if (!_options.Endpoints.EnableDiscoveryEndpoint)
    {
        _logger.LogInformation("Discovery endpoint disabled. 404.");
        return new StatusCodeResult(HttpStatusCode.NotFound);
    }

    var baseUrl = context.GetIdentityServerBaseUrl().EnsureTrailingSlash();
    var issuerUri = context.GetIdentityServerIssuerUri();

    // generate response
    _logger.LogTrace("Calling into discovery response generator: {type}", _responseGenerator.GetType().FullName);
    var response = await _responseGenerator.CreateDiscoveryDocumentAsync(baseUrl, issuerUri);

    return new DiscoveryDocumentResult(response, _options.Discovery.ResponseCacheInterval);
}

/// <summary>
/// Creates the discovery document.
/// </summary>
/// <param name="baseUrl">The base URL.</param>
/// <param name="issuerUri">The issuer URI.</param>
public virtual async Task<Dictionary<string, object>> CreateDiscoveryDocumentAsync(string baseUrl, string issuerUri)
{
    var entries = new Dictionary<string, object>
    {
        { OidcConstants.Discovery.Issuer, issuerUri }
    };

    // jwks
    if (Options.Discovery.ShowKeySet)
    {
        if ((await Keys.GetValidationKeysAsync()).Any())
        {
            entries.Add(OidcConstants.Discovery.JwksUri, baseUrl + Constants.ProtocolRoutePaths.DiscoveryWebKeys);
        }
    }

    // endpoints
    if (Options.Discovery.ShowEndpoints)
    {
        if (Options.Endpoints.EnableAuthorizeEndpoint)
        {
            entries.Add(OidcConstants.Discovery.AuthorizationEndpoint, baseUrl + Constants.ProtocolRoutePaths.Authorize);
        }

        if (Options.Endpoints.EnableTokenEndpoint)
        {
            entries.Add(OidcConstants.Discovery.TokenEndpoint, baseUrl + Constants.ProtocolRoutePaths.Token);
        }

        if (Options.Endpoints.EnableUserInfoEndpoint)
        {
            entries.Add(OidcConstants.Discovery.UserInfoEndpoint, baseUrl + Constants.ProtocolRoutePaths.UserInfo);
        }

        if (Options.Endpoints.EnableEndSessionEndpoint)
        {
            entries.Add(OidcConstants.Discovery.EndSessionEndpoint, baseUrl + Constants.ProtocolRoutePaths.EndSession);
        }

        if (Options.Endpoints.EnableCheckSessionEndpoint)
        {
            entries.Add(OidcConstants.Discovery.CheckSessionIframe, baseUrl + Constants.ProtocolRoutePaths.CheckSession);
        }

        if (Options.Endpoints.EnableTokenRevocationEndpoint)
        {
            entries.Add(OidcConstants.Discovery.RevocationEndpoint, baseUrl + Constants.ProtocolRoutePaths.Revocation);
        }

        if (Options.Endpoints.EnableIntrospectionEndpoint)
        {
            entries.Add(OidcConstants.Discovery.IntrospectionEndpoint, baseUrl + Constants.ProtocolRoutePaths.Introspection);
        }

        if (Options.Endpoints.EnableDeviceAuthorizationEndpoint)
        {
            entries.Add(OidcConstants.Discovery.DeviceAuthorizationEndpoint, baseUrl + Constants.ProtocolRoutePaths.DeviceAuthorization);
        }

        if (Options.MutualTls.Enabled)
        {
            var mtlsEndpoints = new Dictionary<string, string>();

            if (Options.Endpoints.EnableTokenEndpoint)
            {
                mtlsEndpoints.Add(OidcConstants.Discovery.TokenEndpoint, baseUrl + Constants.ProtocolRoutePaths.MtlsToken);
            }
            if (Options.Endpoints.EnableTokenRevocationEndpoint)
            {
                mtlsEndpoints.Add(OidcConstants.Discovery.RevocationEndpoint, baseUrl + Constants.ProtocolRoutePaths.MtlsRevocation);
            }
            if (Options.Endpoints.EnableIntrospectionEndpoint)
            {
                mtlsEndpoints.Add(OidcConstants.Discovery.IntrospectionEndpoint, baseUrl + Constants.ProtocolRoutePaths.MtlsIntrospection);
            }
            if (Options.Endpoints.EnableDeviceAuthorizationEndpoint)
            {
                mtlsEndpoints.Add(OidcConstants.Discovery.DeviceAuthorizationEndpoint, baseUrl + Constants.ProtocolRoutePaths.MtlsDeviceAuthorization);
            }

            if (mtlsEndpoints.Any())
            {
                entries.Add(OidcConstants.Discovery.MtlsEndpointAliases, mtlsEndpoints);
            }
        }
    }

    // logout
    if (Options.Endpoints.EnableEndSessionEndpoint)
    {
        entries.Add(OidcConstants.Discovery.FrontChannelLogoutSupported, true);
        entries.Add(OidcConstants.Discovery.FrontChannelLogoutSessionSupported, true);
        entries.Add(OidcConstants.Discovery.BackChannelLogoutSupported, true);
        entries.Add(OidcConstants.Discovery.BackChannelLogoutSessionSupported, true);
    }

    // scopes and claims
    if (Options.Discovery.ShowIdentityScopes ||
        Options.Discovery.ShowApiScopes ||
        Options.Discovery.ShowClaims)
    {
        var resources = await ResourceStore.GetAllEnabledResourcesAsync();
        var scopes = new List<string>();

        // scopes
        if (Options.Discovery.ShowIdentityScopes)
        {
            scopes.AddRange(resources.IdentityResources.Where(x => x.ShowInDiscoveryDocument).Select(x => x.Name));
        }

        if (Options.Discovery.ShowApiScopes)
        {
            var apiScopes = from api in resources.ApiResources
                            from scope in api.Scopes
                            where scope.ShowInDiscoveryDocument
                            select scope.Name;

            scopes.AddRange(apiScopes);
            scopes.Add(IdentityServerConstants.StandardScopes.OfflineAccess);
        }

        if (scopes.Any())
        {
            entries.Add(OidcConstants.Discovery.ScopesSupported, scopes.ToArray());
        }

        // claims
        if (Options.Discovery.ShowClaims)
        {
            var claims = new List<string>();

            // add non-hidden identity scopes related claims
            claims.AddRange(resources.IdentityResources.Where(x => x.ShowInDiscoveryDocument).SelectMany(x => x.UserClaims));

            // add non-hidden api scopes related claims
            foreach (var resource in resources.ApiResources)
            {
                claims.AddRange(resource.UserClaims);

                foreach (var scope in resource.Scopes)
                {
                    if (scope.ShowInDiscoveryDocument)
                    {
                        claims.AddRange(scope.UserClaims);
                    }
                }
            }

            entries.Add(OidcConstants.Discovery.ClaimsSupported, claims.Distinct().ToArray());
        }
    }

    // grant types
    if (Options.Discovery.ShowGrantTypes)
    {
        var standardGrantTypes = new List<string>
        {
            OidcConstants.GrantTypes.AuthorizationCode,
            OidcConstants.GrantTypes.ClientCredentials,
            OidcConstants.GrantTypes.RefreshToken,
            OidcConstants.GrantTypes.Implicit
        };

        if (!(ResourceOwnerValidator is NotSupportedResourceOwnerPasswordValidator))
        {
            standardGrantTypes.Add(OidcConstants.GrantTypes.Password);
        }

        if (Options.Endpoints.EnableDeviceAuthorizationEndpoint)
        {
            standardGrantTypes.Add(OidcConstants.GrantTypes.DeviceCode);
        }

        var showGrantTypes = new List<string>(standardGrantTypes);

        if (Options.Discovery.ShowExtensionGrantTypes)
        {
            showGrantTypes.AddRange(ExtensionGrants.GetAvailableGrantTypes());
        }

        entries.Add(OidcConstants.Discovery.GrantTypesSupported, showGrantTypes.ToArray());
    }

    // response types
    if (Options.Discovery.ShowResponseTypes)
    {
        entries.Add(OidcConstants.Discovery.ResponseTypesSupported, Constants.SupportedResponseTypes.ToArray());
    }

    // response modes
    if (Options.Discovery.ShowResponseModes)
    {
        entries.Add(OidcConstants.Discovery.ResponseModesSupported, Constants.SupportedResponseModes.ToArray());
    }

    // misc
    if (Options.Discovery.ShowTokenEndpointAuthenticationMethods)
    {
        var types = SecretParsers.GetAvailableAuthenticationMethods().ToList();
        if (Options.MutualTls.Enabled)
        {
            types.Add(OidcConstants.EndpointAuthenticationMethods.TlsClientAuth);
            types.Add(OidcConstants.EndpointAuthenticationMethods.SelfSignedTlsClientAuth);
        }

        entries.Add(OidcConstants.Discovery.TokenEndpointAuthenticationMethodsSupported, types);
    }
    
    var signingCredentials = await Keys.GetSigningCredentialsAsync();
    if (signingCredentials != null)
    {
        var algorithm = signingCredentials.Algorithm;
        entries.Add(OidcConstants.Discovery.IdTokenSigningAlgorithmsSupported, new[] { algorithm });
    }

    entries.Add(OidcConstants.Discovery.SubjectTypesSupported, new[] { "public" });
    entries.Add(OidcConstants.Discovery.CodeChallengeMethodsSupported, new[] { OidcConstants.CodeChallengeMethods.Plain, OidcConstants.CodeChallengeMethods.Sha256 });

    if (Options.Endpoints.EnableAuthorizeEndpoint)
    {
        entries.Add(OidcConstants.Discovery.RequestParameterSupported, true);

        if (Options.Endpoints.EnableJwtRequestUri)
        {
            entries.Add(OidcConstants.Discovery.RequestUriParameterSupported, true);
        }
    }

    if (Options.MutualTls.Enabled)
    {
        entries.Add(OidcConstants.Discovery.TlsClientCertificateBoundAccessTokens, true);
    }

    // custom entries
    if (!Options.Discovery.CustomEntries.IsNullOrEmpty())
    {
        foreach (var customEntry in Options.Discovery.CustomEntries)
        {
            if (entries.ContainsKey(customEntry.Key))
            {
                Logger.LogError("Discovery custom entry {key} cannot be added, because it already exists.", customEntry.Key);
            }
            else
            {
                if (customEntry.Value is string customValueString)
                {
                    if (customValueString.StartsWith("~/") && Options.Discovery.ExpandRelativePathsInCustomEntries)
                    {
                        entries.Add(customEntry.Key, baseUrl + customValueString.Substring(2));
                        continue;
                    }
                }

                entries.Add(customEntry.Key, customEntry.Value);
            }
        }
    }

    return entries;
}

然後是jwks描述信息的代碼。關於加密的信息也是根據配置的SecuritKey去動態返回的。

public virtual async Task<IEnumerable<Models.JsonWebKey>> CreateJwkDocumentAsync()
    {
        var webKeys = new List<Models.JsonWebKey>();
        
        foreach (var key in await Keys.GetValidationKeysAsync())
        {
            if (key.Key is X509SecurityKey x509Key)
            {
                var cert64 = Convert.ToBase64String(x509Key.Certificate.RawData);
                var thumbprint = Base64Url.Encode(x509Key.Certificate.GetCertHash());

                if (x509Key.PublicKey is RSA rsa)
                {
                    var parameters = rsa.ExportParameters(false);
                    var exponent = Base64Url.Encode(parameters.Exponent);
                    var modulus = Base64Url.Encode(parameters.Modulus);

                    var rsaJsonWebKey = new Models.JsonWebKey
                    {
                        kty = "RSA",
                        use = "sig",
                        kid = x509Key.KeyId,
                        x5t = thumbprint,
                        e = exponent,
                        n = modulus,
                        x5c = new[] { cert64 },
                        alg = key.SigningAlgorithm
                    };
                    webKeys.Add(rsaJsonWebKey);
                }
                else if (x509Key.PublicKey is ECDsa ecdsa)
                {
                    var parameters = ecdsa.ExportParameters(false);
                    var x = Base64Url.Encode(parameters.Q.X);
                    var y = Base64Url.Encode(parameters.Q.Y);

                    var ecdsaJsonWebKey = new Models.JsonWebKey
                    {
                        kty = "EC",
                        use = "sig",
                        kid = x509Key.KeyId,
                        x5t = thumbprint,
                        x = x,
                        y = y,
                        crv = CryptoHelper.GetCrvValueFromCurve(parameters.Curve),
                        x5c = new[] { cert64 },
                        alg = key.SigningAlgorithm
                    };
                    webKeys.Add(ecdsaJsonWebKey);
                }
                else
                {
                    throw new InvalidOperationException($"key type: {x509Key.PublicKey.GetType().Name} not supported.");
                }
            }
            else if (key.Key is RsaSecurityKey rsaKey)
            {
                var parameters = rsaKey.Rsa?.ExportParameters(false) ?? rsaKey.Parameters;
                var exponent = Base64Url.Encode(parameters.Exponent);
                var modulus = Base64Url.Encode(parameters.Modulus);

                var webKey = new Models.JsonWebKey
                {
                    kty = "RSA",
                    use = "sig",
                    kid = rsaKey.KeyId,
                    e = exponent,
                    n = modulus,
                    alg = key.SigningAlgorithm
                };

                webKeys.Add(webKey);
            }
            else if (key.Key is ECDsaSecurityKey ecdsaKey)
            {
                var parameters = ecdsaKey.ECDsa.ExportParameters(false);
                var x = Base64Url.Encode(parameters.Q.X);
                var y = Base64Url.Encode(parameters.Q.Y);

                var ecdsaJsonWebKey = new Models.JsonWebKey
                {
                    kty = "EC",
                    use = "sig",
                    kid = ecdsaKey.KeyId,
                    x = x,
                    y = y,
                    crv = CryptoHelper.GetCrvValueFromCurve(parameters.Curve),
                    alg = key.SigningAlgorithm
                };
                webKeys.Add(ecdsaJsonWebKey);
            }
            else if (key.Key is JsonWebKey jsonWebKey)
            {
                var webKey = new Models.JsonWebKey
                {
                    kty = jsonWebKey.Kty,
                    use = jsonWebKey.Use ?? "sig",
                    kid = jsonWebKey.Kid,
                    x5t = jsonWebKey.X5t,
                    e = jsonWebKey.E,
                    n = jsonWebKey.N,
                    x5c = jsonWebKey.X5c?.Count == 0 ? null : jsonWebKey.X5c.ToArray(),
                    alg = jsonWebKey.Alg,

                    x = jsonWebKey.X,
                    y = jsonWebKey.Y
                };

                webKeys.Add(webKey);
            }
        }

        return webKeys;
    }

結語

這一節還是比較好理解的。總而言之就是oidc協議規定了，需要提供GET介面，返回所有介面的地址，以及相關配置信息。idsv4的實現方式就是介面地址根據協議規定的去拼接，其他配置項信息根據開發的配置去動態獲取，然後以協議約定的JSON格式返回。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 11.面向對象-----封裝性
    一、為何要引入封裝性？ 程式設計的重點是追求高內聚、低耦合： > 高內聚：類的內部數據操作細節自己完成，不允許外部干涉 > 低耦合：僅對外暴露少量的方法用於使用 隱藏對象內部的複雜性，只對外公開簡單的介面。便於外界調用，從而提高系統的可擴展性、可維護性。 二、問題的引入 當我們創建一個類的對象以後， ...
  • 拿 C# 搞函數式編程 - 3
    前言 今天和某個人聊天聊到了 C 的 LINQ，發現我認識的 LINQ 似乎和大多數人認識的 LINQ 不太一樣，怎麼個不一樣法呢？其實 LINQ 也可以用來搞函數式編程。 當然，並不是說寫幾個 和用用像 Java 那樣的 之類的就算叫做 LINQ 了，LINQ 其實是一個另外的一些東西。 LINQ ...
  • IdentityServer4源碼解析_4_令牌發放介面
    目錄 "identityserver4源碼解析_1_項目結構" "identityserver4源碼解析_2_元數據介面" "identityserver4源碼解析_3_認證介面" "identityserver4源碼解析_4_令牌發放介面" "identityserver4源碼解析_5_查詢用戶信 ...
  • 開源項目QRCoder介紹
    QRCoder是一個簡單的庫，用C＃.NET編寫，可讓您創建QR碼。 它與其他庫沒有任何依賴關係，並且可以在NuGet上以.NET Framework和.NET Core PCL版本獲得。 有關更多信息，請參見：QRCode Wiki | 創作者的博客（英語）| 創作者的博客（德語） QRCo... ...
  • 記一次Mongodb資料庫更新操作之更新為數組或者對象
    一直以來都是更新為一些簡單的基礎類型，直到有一天寫了一個覆蓋某一個欄位（這個欄位為數組）的更新操作。出問題了，資料庫中出現了_t,_v……有點懵了。當然如果我們更新的時候設置類型是不會出現這個問題的，出現這種問題的一個前提是我們將數組賦值給了object類型的變數；由於時間關係問了一下同事，她給出了 ...
  • .net Core項目發佈到Docker for Windows
    1.生成的Dockerfile 拿到外層根目錄(ps:生成Dockerfile文件需要選擇linux) 2.控制台進入對應文件夾 3.docker build -t debugbox/api（debugbox/api是給項目起的名）a . （這裡的點代表當前目錄）（loading…… 生成鏡像） 4 ...
  • C#/.net core 分散式服務消息一致性方案
    分散式部署服務的情況下，由於網路狀況不可預期，消息有可能發送成功，但是消費端消費失敗；也有可能消息根本沒有發出去，如何保證消息是否發送成功是經常遇到的問題。最近有時間研究了一下，具體方法如下圖： 表結構設計如下： 具體思路： 正常流程（網路都正常） 1.消息生產方，將消息信息與業務數據在同一個事務中 ...
  • identityserver4源碼解析_3_認證介面
    目錄 "identityserver4源碼解析_1_項目結構" "identityserver4源碼解析_2_元數據介面" "identityserver4源碼解析_3_認證介面" "identityserver4源碼解析_4_令牌發放介面" "identityserver4源碼解析_5_查詢用戶信 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類