From 71a72a11784791c38b13cd18dca7ef9bd321a083 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Thu, 16 Mar 2023 22:56:52 +0100 Subject: [PATCH 1/3] Add rtweet_oauth2 explanation --- vignettes/auth.Rmd | 52 ++++++++++++++++++++++++++++++++++++------- vignettes/oauth2.png | Bin 0 -> 13016 bytes 2 files changed, 44 insertions(+), 8 deletions(-) create mode 100644 vignettes/oauth2.png diff --git a/vignettes/auth.Rmd b/vignettes/auth.Rmd index b262c864..b484d6f0 100644 --- a/vignettes/auth.Rmd +++ b/vignettes/auth.Rmd @@ -57,7 +57,7 @@ You'll only see this once, so make sure to record it in a secure location. ![](app-info.png){width="548"} Don't worry if you forget to save this data: you can always regenerate new values by clicking the "regenerate" button on the "keys and tokens" page. -If you regenerate the previous values will cease to work, so do not use it to get different credentials for an authentication already in use. +If you regenerate the previous values will cease to work, so do not use it to get different credentials for an authentication already in use. ## Setup @@ -67,7 +67,7 @@ You'll use either `rtweet_app()` or `rtweet_bot()` depending on whether you want ### User By default `rtweet` uses a common user for all the users. -Using the default authentication might cause problems while using rtweet. +Using the default authentication might cause problems while using rtweet. You are sharing the same resource with many people! If you use rtweet for more than a day or a learning how to use the package it is recommended to set up your own authentication and you don't want to set up a bot or an app you can use `auth_setup_default()`: @@ -78,6 +78,43 @@ auth_setup_default() It will call `rtweet_user()` to use your current logged account on your default browser as the authentication used by `rtweet` and save it as "default" (See [Saving and loading](#save)). +#### Alternative authorization protocol + +Some new functions require a different authentication mechanism[^1]. +This functions will need you to first set up a client, which requires your client id and secret. + +[^1]: Called [OAuth 2](https://aaronparecki.com/oauth-2-simplified/) + +You can get them in your [developer dashboard](https://developer.twitter.com/en/portal/dashboard) after selecting your project. +The clients are under "Key and tokens" tab, check the top. +At the last section of the tab, there is the section \"Auth 2.0 Client ID and Client Secret\": + +![Screenshoot showing what to look to get the OAuth credentials](oauth2.png){width="548"} + +Use them to set up your client app: + +```{r client} +client <- rtweet_client() +client_save(client) +client_as(client) +``` + +Once you get your client you'll need to tell rtweet to use it (that's why we use `client_as()`). +But first you'll need to authorize it via `rtweet_oauth2()`: +It will ask your default browser to authorize the client. +You should have a Twitter session to authorize rtweet. + +```{r rtweet_oauth2} +user_oauth2 <- rtweet_oauth2() +## Waiting for authentication in browser... +## Press Esc/Ctrl + C to abort +auth_as(user_oauth2) +auth_save(user_oauth2, "oauth2_authentication") +``` + +This authentication only last for 2 hours. +You'll be asked to renew the authorization if it is expired. + ### Apps To use app based authentication, run this code: @@ -139,7 +176,7 @@ You can see all the authentication options you have saved with `auth_list()`. `auth_list()` reports all the available authentications at the default location (See `auth_save()` details). If you use an authentication saved on a different path you can directly use it `auth_as("../authentications/rtweet.rds")` -`auth_setup_default()` saves the authentication as default. +`auth_setup_default()` saves the authentication as default. So, after your initial setup you can start all your scripts with `auth_as("default")` to load it. ### On continuous integration workflows @@ -153,7 +190,7 @@ You will need to provide a name of your variable, try to be informative (RTWEET_ Usually you later need to load them from the environmental variables and create the token on the CI: -```r +``` r app <- rtweet_app(bearer_token = Sys.getenv("RTWEET_BEARER")) auth_as(app) ``` @@ -163,13 +200,12 @@ Also do not print RTWEET_BEARER or other secrets. ## Authentications sitrep -On the rtweet 1.0.0 version there were some changes on the default location of the tokens. +On the rtweet 1.0.0 version there were some changes on the default location of the tokens. If you upgrade or want a complete check up of your authentications you can use `auth_sitrep()`. It can help when regenerating credentials and to follow best practices when upgrading rtweet. It will print something like these: - ```{r, eval = FALSE} auth_sitrep() ## Tokens from rtweet version < 1.0.0 found on /home/user: @@ -189,8 +225,8 @@ auth_sitrep() ## All tokens should be moved to /home/user/.config/R/rtweet ``` -First looks up old authentications rtweet saved at your home directory (`~`, or `$HOME`) as it did on rtweet < 1.0.0. -Then it reports the authentications found on the new location (rtweet >= 1.0.0). +First looks up old authentications rtweet saved at your home directory (`~`, or `$HOME`) as it did on rtweet \< 1.0.0. +Then it reports the authentications found on the new location (rtweet \>= 1.0.0). For each folder it reports apps and then users and bots authentications. It is safe to use in public, as instead of the tokens or keys it reports a letter. For users authentications it reports the user_id, so that you can check who is that user (`search_users("1251053384")`). diff --git a/vignettes/oauth2.png b/vignettes/oauth2.png new file mode 100644 index 0000000000000000000000000000000000000000..6eec9a1ba16b51a0348c62f35383fce5b3e6c0c5 GIT binary patch literal 13016 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 Date: Fri, 17 Mar 2023 00:40:04 +0100 Subject: [PATCH 2/3] Fix problem with rtweet_client --- R/client.R | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/R/client.R b/R/client.R index 664b285d..65380fce 100644 --- a/R/client.R +++ b/R/client.R @@ -189,7 +189,7 @@ no_client <- function(call = caller_env()) { #' @seealso scopes #' @export #' @examples -#' if (!client_has_default()) { +#' if (interactive()) { #' rtweet_client() #' } rtweet_client <- function(client_id, client_secret, From d3900e4e8189463c6615d03a6be7bb9248952bf3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Llu=C3=ADs?= Date: Mon, 20 Mar 2023 23:55:22 +0100 Subject: [PATCH 3/3] Fix documentation of how to get it for new accounts. Based on the exchange in: https://discuss.ropensci.org/t/option-to-isolate-bookmarked-tweets/3391/16 --- vignettes/auth.Rmd | 8 +++++++- vignettes/oauth2.png | Bin 13016 -> 61308 bytes 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/vignettes/auth.Rmd b/vignettes/auth.Rmd index b484d6f0..718cd439 100644 --- a/vignettes/auth.Rmd +++ b/vignettes/auth.Rmd @@ -85,7 +85,13 @@ This functions will need you to first set up a client, which requires your clien [^1]: Called [OAuth 2](https://aaronparecki.com/oauth-2-simplified/) -You can get them in your [developer dashboard](https://developer.twitter.com/en/portal/dashboard) after selecting your project. +You can get them in your [developer dashboard](https://developer.twitter.com/en/portal/dashboard) after selecting your app, you first need to fill the details of the "User authentication settings": + +**App permissions**: Read, Read and write, or Read and write and Direct message +**Type of App**: Native app +**App info** +Callback URI: http://127.0.0.1:1410/ + The clients are under "Key and tokens" tab, check the top. At the last section of the tab, there is the section \"Auth 2.0 Client ID and Client Secret\": diff --git a/vignettes/oauth2.png b/vignettes/oauth2.png index 6eec9a1ba16b51a0348c62f35383fce5b3e6c0c5..8388256d3b29eb1608609e8fe1c876a595e835b1 100644 GIT binary patch literal 61308 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 literal 13016 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