Tapis.Core.Push
1.0.0
dotnet add package Tapis.Core.Push --version 1.0.0
NuGet\Install-Package Tapis.Core.Push -Version 1.0.0
<PackageReference Include="Tapis.Core.Push" Version="1.0.0" />
<PackageVersion Include="Tapis.Core.Push" Version="1.0.0" />
<PackageReference Include="Tapis.Core.Push" />
paket add Tapis.Core.Push --version 1.0.0
#r "nuget: Tapis.Core.Push, 1.0.0"
#:package Tapis.Core.Push@1.0.0
#addin nuget:?package=Tapis.Core.Push&version=1.0.0
#tool nuget:?package=Tapis.Core.Push&version=1.0.0
Tapis.Core.Push
FCM HTTP v1 push bildirimi göndericisi. Kalıcılık yoktur: token'ın saklanması ve geçersiz token'ın silinmesi çağıranın işidir
(müşteri portalı için Tapis.Core.Portal IPortalPushHedefleri). Ek NuGet bağımlılığı yoktur (yalnız Microsoft.Extensions.*).
Kayıt ve yapılandırma
services.AddFcmPush(configuration); // IPushSender (singleton)
| Anahtar (ortam değişkeni) | Anlamı |
|---|---|
Push:Fcm:Etkin (Push__Fcm__Etkin) |
Varsayılan false: gönderici hiçbir istek yapmaz, PushSonucDurumu.Atlandi döner |
Push:Fcm:ProjeId |
Firebase proje kimliği, ^[a-z][a-z0-9-]{4,28}[a-z0-9]$ |
Push:Fcm:HizmetHesabiEposta |
Yalnız FCM gönderici rolündeki hizmet hesabı (…@….iam.gserviceaccount.com) |
Push:Fcm:OzelAnahtar |
Hizmet hesabının RSA özel anahtarı (PEM; ortam değişkeninde literal \n olabilir). Sır: yalnız sunucu .env'i |
Etkin=true iken eksik/geçersiz değer her ortamda AddFcmPush sırasında InvalidOperationException verir (geri düşüş yok; iletide değer yoktur).
PEM başlangıçta bir kez ayrıştırılır (en az 2048 bit).
Davranış
- Host'lar kodda sabittir:
fcm.googleapis.com(gönderim) veoauth2.googleapis.com(token). Yapılandırmada yalnızProjeIdvardır; yönlendirme izlenmez. - OAuth2: hizmet hesabı JWT'si (RS256, .NET kriptografisi)
jwt-bearergrant ile değiştirilir; kapsam tam olarakhttps://www.googleapis.com/auth/firebase.messaging. Erişim token'ı ~50 dk bellekte önbelleğe alınır; yenileme tek uçuşludur. IHttpClientFactoryadlı istemci (Tapis.Core.Push.Fcm), zaman aşımı 10 sn.GonderAsync(PushMesaji)→PushSonucu:
| Durum | Ne zaman | Çağıran |
|---|---|---|
Gonderildi |
2xx | — |
TokenGecersiz |
UNREGISTERED, SENDER_ID_MISMATCH; INVALID_ARGUMENT yalnız hata ayrıntısı message.token alanını gösteriyorsa |
token'ı siler |
Gecici |
429, 5xx, zaman aşımı, ağ hatası, OAuth geçici hata | sonraki turda tekrar dener (paket tekrar denemez) |
YetkiHatasi |
OAuth reddi, 401 (yenileme + tek tekrar sonrası), 403 PERMISSION_DENIED/THIRD_PARTY_AUTH_ERROR |
yapılandırmayı düzeltir; token silinmez |
Reddedildi |
Diğer kalıcı 4xx (token'a bağlanamayan INVALID_ARGUMENT dahil) |
token silinmez, tekrar denenmez |
Atlandi |
Etkin=false |
— |
401 alınırsa OAuth token'ı bir kez yenilenir ve istek bir kez tekrarlanır.
Günlük (M6)
Yalnız HTTP durumu, FCM errorCode enum adı (bilinen adlar listesinden) ve istisna tür adı. Yanıt gövdesi, ex.Message, kayıt token'ı, assertion JWT'si ve
erişim token'ı asla yazılmaz; PushMesaji.ToString() token içermez.
Mesaj içeriği
Mesaj notification{title,body}, Android priority=high (+ isteğe bağlı channel_id) ve apns.payload.aps.sound taşır; data değerleri düz metindir.
İçerik kuralı çağırana aittir (müşteri portalı: kişisel veri, kimlik ve URL taşımayan genel metin).
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Extensions.Http (>= 10.0.10)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.10)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Tapis.Core.Push:
| Package | Downloads |
|---|---|
|
Tapis.Core.Portal
Tapis.Core musteri portali modulu: davet kodu ile cihaz baglama, kisa omurlu PortalToken, kayan yenileme oturumu, aydinlatma rizasi ve controller taban siniflari. Her urun kendi veritabaninda barindirir. Publicly distributed proprietary software. Usage is subject to LICENSE.txt. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.0 | 116 | 11/8/2026 |
Ilk surum: FCM HTTP v1 gonderici (kalicilik yok). AddFcmPush, IPushSender, Push:Fcm:{Etkin,ProjeId,HizmetHesabiEposta,OzelAnahtar}. Hostlar kodda sabit (fcm.googleapis.com, oauth2.googleapis.com); OAuth2 hizmet hesabi JWT'si (RS256, kapsam yalniz firebase.messaging) .NET kriptografisiyle imzalanir, ek NuGet yok. Etkin=true iken eksik/gecersiz yapilandirma her ortamda baslangicta hata verir; Etkin=false iken gonderici atlandi doner.