Słownik

Dlaczego token dostępu LinkedIn wygasa po 60 dniach

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Dlaczego token dostępu LinkedIn wygasa po 60 dniachDlaczego token dostępu LinkedIn wygasa po 60 dniach

TL;DR, szybka odpowiedź

8 min czytania

LinkedIn podaje w dokumentacji, że "all access tokens are issued with a 60-day lifespan", a jego przykładowa odpowiedź zwraca expires_in 5184000, czyli dokładnie 60 dni. Programowe tokeny odświeżania działają 365 dni, nie resetują się po użyciu i są dostępne tylko dla zatwierdzonych partnerów Marketing Developer Platform. Żądanie nowego zakresu unieważnia wszystkie posiadane tokeny. 60-dniowy token Mety zwraca 5183944, czyli o 56 sekund mniej, a pochodny token strony w ogóle nie wygasa.

Jak długo działa token dostępu LinkedIn?

Każdy token dostępu LinkedIn wydany w ramach przepływu authorization code ma ten sam czas życia, a LinkedIn podaje go bez zastrzeżeń: "Currently, all access tokens are issued with a 60-day lifespan." To zdanie znajduje się w tabeli pól odpowiedzi przy expires_in na stronie o trójstronnym OAuth, czyli przepływie, z którego korzysta każda integracja publikująca posty.

Przykładowa odpowiedź opublikowana na tej stronie zgadza się z tym zdaniem co do sekundy:

{
  "access_token": "AQUvlL_DYEzvT2wz1QJiEPeLioeA",
  "expires_in": 5184000,
  "scope": "r_basicprofile"
}

5 184 000 sekund to dokładnie 60 dni, bez żadnego zaokrąglenia. Warto jednak czytać pole, a nie zdanie. LinkedIn sam zaleca: "Access tokens stay valid until the number of seconds indicated in the expires_in field in the API response", a expires_in to jedyna wartość pokazująca, co faktycznie dostał twój token.

Jaki czas życia mają poszczególne tokeny LinkedIn?

Jest kilka rodzajów poświadczeń i w niczym się nie przypominają.

PoświadczenieUdokumentowany czas życiaSkąd pochodzi
Kod autoryzacji30 minutGET /oauth/v2/authorization
Trójstronny token dostępu60 dniPOST /oauth/v2/accessToken
Dwustronny token aplikacji30 minutgrant_type=client_credentials
Programowy token odświeżania365 dniZwracany razem z tokenem dostępu

Kod autoryzacji to pierwsza pułapka. LinkedIn pisze, że "the authorization code has a 30-minute lifespan and must be used immediately", a jeśli wygaśnie, "you must repeat all of the previous steps to request another authorization code."

Token dwustronny zaskakuje inaczej. Strona LinkedIn o client credentials podaje: "The access token has a 30-minute lifespan and must be used immediately", a przykład zwraca "expires_in": "1800" jako ciąg znaków w cudzysłowie, a nie liczbę całkowitą jak w przepływie trójstronnym. Przepływ dwustronny jest też niedostępny dla API, których potrzebuje większość narzędzi do publikacji: "2-legged OAuth authentication is not available for Marketing APIs."

Telefon z ekranem logowania, co obrazuje ponowną autoryzację, którą LinkedIn pokazuje, gdy token odświeżania jest niedostępny.

Czy LinkedIn daje token odświeżania?

Tylko jeśli cię do tego zatwierdzi. Strona o tokenach odświeżania zaczyna się od tego warunku: "LinkedIn supports programmatic refresh tokens for all approved Marketing Developer Platform (MDP) partners", a strona o przepływie authorization code powtarza to z drugiej strony, mówiąc, że programowe tokeny odświeżania "are available for a limited set of partners."

Jeśli twojej aplikacji nie ma w tej grupie, udokumentowana przez LinkedIn ścieżka odświeżania w ogóle nie jest typem grantu. Polega na ponownym skierowaniu członka przez /oauth/v2/authorization. LinkedIn opisuje to jako proces płynny i rzeczywiście taki może być, bo ekran zgody jest pomijany, gdy spełnione są dwa warunki: "The member is still logged into www.linkedin.com" oraz "The member's current access token has not expired." Jeśli któregoś brakuje, użytkownik znów zobaczy pełny ekran autoryzacji.

Dlatego LinkedIn radzi odświeżać wcześniej: "Make sure your application refreshes access tokens before they expire, to avoid unnecessarily sending your application's users through the authorization process again." Token odświeżony 55. dnia odnowi się po cichu. Tokenu odświeżanego 61. dnia nie da się już odnowić.

Zatwierdzeni partnerzy wymieniają za to token odświeżania:

POST https://www.linkedin.com/oauth/v2/accessToken
 
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&refresh_token={refresh_token}&client_id={client_id}&client_secret={client_secret}

Jak długo działa token odświeżania LinkedIn?

365 dni, a licznik nigdy się nie resetuje. LinkedIn pisze, że "access tokens are valid for 60 days and programmatic refresh tokens are valid for a year", a potem wyjaśnia konsekwencję, która wielu zaskakuje: "When you use a refresh token to generate a new access token, the lifespan or Time To Live (TTL) of the refresh token remains the same as specified in the initial OAuth flow (365 days), and the new access token has a new TTL of 60 days."

Przykład podany przez LinkedIn warto czytać dosłownie:

  • Dzień 1: token odświeżania ma 365 dni, token dostępu 60.
  • Dzień 59: odświeżenie daje nowy 60-dniowy token dostępu, a tokenowi odświeżania zostaje 306 dni.
  • Dzień 360: "your access token and refresh token will both expire in 5 days (365-360=5) and you must get your application reauthorized by the member."

Token odświeżania daje więc mniej więcej sześć cichych odnowień, po których członek musi znów kliknąć Zezwól. Nie ma okna kroczącego, rotacji tokenów wydłużającej horyzont ani udokumentowanego sposobu na uzyskanie dłuższego czasu.

Co naprawdę zwraca refresh_token_expires_in?

Tutaj LinkedIn przeczy sam sobie, a arytmetyka to obnaża. Pole jest opisane jako "The number of seconds remaining until the refresh token expires." Przykładowa odpowiedź na tej samej stronie zwraca:

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

{
  "refresh_token_expires_in": 525600,
  "scope": "r_basicprofile"
}

525 600 sekund to 6,08 dnia, a więc ani rok, ani żaden udokumentowany czas życia w LinkedIn. Za to 525 600 minut to dokładnie 365 dni. Przykład podaje minuty, a opis pola mówi o sekundach.

Drugi przykład to potwierdza. Po odświeżeniu strona LinkedIn pokazuje "refresh_token_expires_in": 439200. Różnica między tymi wartościami wynosi 86 400, a 86 400 minut to 60 dni, czyli dokładnie odstęp opisany w przykładzie między wydaniem tokenu odświeżania a jego pierwszym użyciem. Obie wartości są spójne jako minuty i bezsensowne jako sekundy.

Traktuj opis pola jako wiążący, a liczby z przykładów jako błąd w dokumentacji. Jeśli zapisujesz bezwzględną datę wygaśnięcia, wyliczaj ją z tego, co zwraca działające API, a nie z którejkolwiek liczby z tej strony.

Programista przegląda logi błędów na laptopie, co jest typową czynnością, gdy token LinkedIn przestaje działać przed upływem 60 dni.

Co unieważnia token dostępu LinkedIn przed upływem 60 dni?

Cztery rzeczy, wszystkie udokumentowane.

Żądanie innego zakresu najbardziej zaskakuje programistów, bo nic nie psuje się widocznie, dopóki się nie zepsuje. LinkedIn pisze: "If you request a different scope than the previously granted scope, all the previous access tokens are invalidated." Wdrożenie wersji dodającej jedno uprawnienie unieważnia tokeny wszystkich obecnych użytkowników. Ta sama strona osobno ostrzega, że "If the scope permissions are changed in your app, your users must re-authenticate."

Drugi powód to cofnięcie przez LinkedIn, a firma otwarcie zastrzega sobie to prawo: "LinkedIn reserves the right to revoke Refresh Tokens or Access Tokens at any time due to technical or policy reasons. In such scenarios, the expectation from products leveraging Refresh Tokens is to fallback to the standard OAuth flow, and present the login screen to the end users."

Trzeci to cofnięcie przez członka. Członek, który odłączy twoją aplikację w ustawieniach LinkedIn, natychmiast kończy dostęp.

Czwarty to próba odświeżenia martwym poświadczeniem, która zwraca konkretny błąd: 400 invalid_request "The provided authorization grant or refresh token is invalid, expired or revoked". Kolumna z rozwiązaniem podaje jeden sposób: "reauthenticate the member to generate the new refresh token."

Nie musisz zgadywać, co się stało. POST https://www.linkedin.com/oauth/v2/introspectToken przyjmuje client_id, client_secret oraz sam token i zwraca status o wartości revoked, expired lub active, a także expires_at, created_at, authorized_at i auth_type. To właśnie to wywołanie warto wykonać, gdy zaplanowane posty na LinkedInie przestają działać na jednym koncie, a na innych nie.

Cztery sposoby, w jakie token LinkedIn ginie wcześniej
1
Zmiana zakresu. Żądanie nowego uprawnienia unieważnia wszystkie wydane tokeny dostępu.
2
Cofnięcie przez LinkedIn. LinkedIn zastrzega sobie prawo do cofnięcia tokenu z przyczyn technicznych lub regulaminowych.
3
Cofnięcie przez członka. Członek odłącza twoją aplikację w ustawieniach LinkedIn.
4
Nieudana próba odświeżenia. Odświeżenie nieprawidłowym, wygasłym lub cofniętym tokenem zwraca błąd 400 bez drugiej szansy.
Każda z tych sytuacji może zakończyć działanie tokenu LinkedIn na wiele dni przed udokumentowanym terminem 60 dni.

Czym to się różni od 60-dniowego tokenu Mety?

Obie platformy mówią o 60 dniach. Prawie nic więcej się nie zgadza.

LinkedInMeta
Udokumentowany czas tokenu użytkownika60 dni"about 60 days"
Zwracane expires_in51840005183944
Sposób odnowieniaPonowna autoryzacja lub grant_type=refresh_token dla partnerów MDPgrant_type=fb_exchange_token
Odnowienie wygasłym tokenemNieNie
Opcja bez wygasaniaBrak w dokumentacjiToken dostępu strony

To liczba Mety jest nietypowa. Przykładowa odpowiedź zwraca "expires_in": 5183944, czyli o 56 sekund mniej niż 60 dni, a sformułowanie Mety jest celowo luźne: "long-lived tokens last about 60 days." Meta dodaje też zastrzeżenie, którego nie ma LinkedIn, i radzi nie polegać na tym czasie, bo tokeny "may change without warning or expire early." Pełne omówienie znajdziesz w tekście o długotrwałym tokenie dostępu Facebooka.

Prawdziwa różnica dotyczy końca łańcucha. Meta pozwala uzyskać z długotrwałego tokenu użytkownika token dostępu strony i podaje, że takie tokeny "do not have an expiration date." LinkedIn nie publikuje odpowiednika i w jednym zdaniu w sekcji o odświeżaniu mówi coś odwrotnego: "To protect members' data, LinkedIn does not generate long-lived access tokens." LinkedIn traktuje więc swój 60-dniowy token jako krótkotrwały.

Dla osób budujących integracje z obiema platformami wygląda to w praktyce tak. U Mety można uzyskać poświadczenie, które przeżyje sesję członka. Na LinkedInie nie, więc prośba o ponowne połączenie to stały element integracji, a nie stan awarii, a niezawodne planowanie postów na LinkedInie oznacza przygotowanie się na dzień, w którym członek znów będzie musiał kliknąć Zezwól.

Najczęściej zadawane pytania

Jaką wartość zwraca expires_in dla tokenu dostępu LinkedIn?

5184000 w opublikowanym przez LinkedIn przykładzie, czyli dokładnie 60 dni w sekundach.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Czy można przedłużyć token dostępu LinkedIn ponad 60 dni?

Nie. LinkedIn wydaje nowy 60-dniowy token, albo przez token odświeżania, jeśli twoja aplikacja jest zatwierdzonym partnerem MDP, albo po ponownym przeprowadzeniu członka przez autoryzację.

Jak długo ważny jest kod autoryzacji LinkedIn?

30 minut. LinkedIn pisze, że "must be used immediately", a wygasły kod oznacza powtórzenie wszystkich wcześniejszych kroków.

Czy odświeżenie resetuje termin ważności tokenu odświeżania?

Nie. LinkedIn podaje, że TTL tokenu odświeżania "remains the same as specified in the initial OAuth flow (365 days)", niezależnie od tego, jak często go używasz.

Dlaczego wszystkie tokeny LinkedIn przestały działać naraz?

Najbardziej prawdopodobna przyczyna to zmiana zakresu. LinkedIn unieważnia wszystkie wcześniej przyznane tokeny dostępu, gdy aplikacja zażąda zakresu innego niż już przyznany.

Jak sprawdzić, czy token został cofnięty lub wygasł?

Wywołaj POST https://www.linkedin.com/oauth/v2/introspectToken z danymi klienta i tokenem. Pole status zwraca revoked, expired lub active.

Co się dzieje, gdy token odświeżania LinkedIn wygasa razem z tokenem dostępu?

W przykładzie LinkedIn dzieje się to 360. dnia, gdy obu tokenom zostaje pięć dni. Po upływie tego czasu członek musi przejść autoryzację od nowa, bo żaden typ grantu nie odnowi wygasłego tokenu odświeżania. Na stronie o tokenach odświeżania nie ma żadnej udokumentowanej drogi przedłużenia.

Dlaczego większość narzędzi do publikacji nie może polegać na dwustronnym tokenie LinkedIn?

Token client credentials działa tylko 30 minut, a LinkedIn podaje, że jest niedostępny dla Marketing APIs, z których korzystają narzędzia do planowania i publikacji. Jego przykładowa odpowiedź zwraca nawet expires_in jako ciąg "1800" zamiast liczby całkowitej z przepływu trójstronnego. Każda aplikacja publikująca w imieniu członka musi użyć przepływu trójstronnego.

Czy liczba 5 184 000 sekund zgadza się z 60 dniami podawanymi przez LinkedIn?

Zgadza się dokładnie. Dokumentacja podaje 60 dni, a przykładowa wartość expires_in równa 5184000 sekund to dokładnie 60 dni bez zaokrąglenia. Ta precyzja sprawia, że rozbieżność między minutami a sekundami w polu refresh_token_expires_in tym bardziej rzuca się w oczy w tej samej dokumentacji.

Czy LinkedIn wydaje token, który nigdy nie wygasa?

LinkedIn nie dokumentuje takiej opcji. Każdy token dostępu ma 60-dniowy czas życia, a firma wprost podaje, że nie generuje długotrwałych tokenów dostępu, w przeciwieństwie do Mety, która pozwala uzyskać z długotrwałego tokenu użytkownika token dostępu strony bez daty wygaśnięcia.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły