feat(telegram_token): Add TelegramBotTokenDetector plugin

detect_secrets/core/usage.py

@@ -618,6 +618,12 @@ class PluginOptions:
             help_text='Disables scans for GitHub credentials',
             filename='github_token',
         ),
+        PluginDescriptor(
+            classname='TelegramBotTokenDetector',
+            flag_text='--no-telegram-bot-token-scan',
+            help_text='Disables scans for Telegram bot tokens',
+            filename='telegram_token',
+        ),
     ]
     opt_in_plugins = [
         PluginDescriptor(

detect_secrets/plugins/telegram_token.py

@@ -0,0 +1,37 @@
+"""
+This plugin searches for Telegram bot tokens
+"""
+import re
+
+import requests
+
+from detect_secrets.core.constants import VerifiedResult
+from .base import RegexBasedDetector
+
+
+class TelegramBotTokenDetector(RegexBasedDetector):
+    """Scans for Telegram bot tokens."""
+    secret_type = 'Telegram Bot Token'
+
+    denylist = [
+        # refs https://core.telegram.org/bots/api#authorizing-your-bot
+        re.compile(r'^\d{8,10}:[0-9A-Za-z_-]{35}$'),
+    ]
+
+    def verify(self, token, *args, **kwargs):  # pragma: no cover
+        try:
+            response = requests.get(
+                'https://api.telegram.org/bot{}/getMe'.format(
+                    token,
+                ),
+                timeout=5,
+            )
+        except requests.exceptions.RequestException:
+            return VerifiedResult.UNVERIFIED
+
+        if response.status_code == 200:
+            return VerifiedResult.VERIFIED_TRUE
+
+        # For unexpected status codes (e.g., 429/5xx), avoid
+        # incorrectly marking the token as invalid.
+        return VerifiedResult.UNVERIFIED

tests/plugins/telegram_token_test.py

@@ -0,0 +1,23 @@
+import pytest
+
+from detect_secrets.plugins.telegram_token import TelegramBotTokenDetector
+
+
+class TestTelegramTokenDetector:
+
+    @pytest.mark.parametrize(
+        'payload, should_flag',
+        [
+            ('bot110201543:AAHdqTcvCH1vGWJxfSe1ofSAs0K5PALDsaw', False),
+            ('110201543:AAHdqTcvCH1vGWJxfSe1ofSAs0K5PALDsaw', True),
+            ('7213808860:AAH1bjqpKKW3maRSPAxzIU-0v6xNuq2-NjM', True),
+            ('foo:AAH1bjqpKKW3maRSPAxzIU-0v6xNuq2-NjM', False),
+            ('foo', False),
+            ('arn:aws:sns:aaa:111122223333:aaaaaaaaaaaaaaaaaaassssssddddddddddddd', False),
+        ],
+    )
+    def test_analyze(self, payload, should_flag):
+        logic = TelegramBotTokenDetector()
+        output = logic.analyze_line(payload, 1, 'mock_filename')
+
+        assert len(output) == int(should_flag)